@opengeni/react 1.0.2-canary.37191796234001 → 1.0.2

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

@@ -11,6 +11,7 @@ import {
 import { useOpenGeni, type ClientOverride } from "../session-context";
 import { SessionConversation, type SessionConversationProps } from "./session-conversation";
 import { SessionList, type SessionListLabels, type SessionListProps } from "./session-list";
+import { SessionProxyScope, type SessionProxyBaseUrl } from "./session-proxy-scope";
 
 export type OpenGeniChatLabels = SessionListLabels & {
   openChats: string;
@@ -31,41 +32,47 @@ const DEFAULT_LABELS: Omit<OpenGeniChatLabels, keyof SessionListLabels> = {
   newChatUnavailable: "New chats are not enabled for this product.",
 };
 
-export type OpenGeniChatProps = ClientOverride & {
-  /** Controlled selection. `null` shows the new-chat composer. */
-  sessionId?: string | null | undefined;
-  /** Initial selection when uncontrolled. Defaults to a new chat. */
-  defaultSessionId?: string | null | undefined;
-  onSessionChange?: ((sessionId: string | null) => void) | undefined;
-  /**
-   * Create a chat from its first message. Defaults to `client.createSession`
-   * with `{ initialMessage, idempotencyKey }`, which `createSessionProxyHandler`
-   * accepts when the server supplies a `createSession` hook. Return the new id.
-   */
-  createSession?: ((initialMessage: string, idempotencyKey: string) => Promise<string>) | undefined;
-  /** Hide the "New chat" entry point. */
-  newChat?: boolean | undefined;
-  /** Forwarded to the conversation (message rendering, tool renderers, composer...). */
-  conversationProps?: Omit<SessionConversationProps, "sessionId" | "client" | "workspaceId">;
-  /** Forwarded to the list (rename/archive toggles, page size). */
-  listProps?: Pick<SessionListProps, "rename" | "archive" | "pageSize"> | undefined;
-  labels?: Partial<OpenGeniChatLabels> | undefined;
-  className?: string | undefined;
-  /** Defaults to filling the host. */
-  height?: CSSProperties["height"];
-  /**
-   * Light or dark. Defaults to `auto`: follow the host page (an enclosing
-   * `data-og-theme`, `class="dark"`/`data-theme` on <html> or <body>, the
-   * host's `color-scheme`, then its background), not the OS setting alone.
-   */
-  theme?: HostThemePreference | undefined;
-  /**
-   * `host` (default) derives backgrounds and cards from the host background so
-   * the chat blends in; `theme` uses the `--og-color-*` surface tokens as they
-   * are. Customized surface tokens are always kept.
-   */
-  surface?: HostSurfacePreference | undefined;
-};
+export type OpenGeniChatProps = ClientOverride &
+  SessionProxyBaseUrl & {
+    /** Controlled selection. `null` shows the new-chat composer. */
+    sessionId?: string | null | undefined;
+    /** Initial selection when uncontrolled. Defaults to a new chat. */
+    defaultSessionId?: string | null | undefined;
+    onSessionChange?: ((sessionId: string | null) => void) | undefined;
+    /**
+     * Create a chat from its first message. Defaults to `client.createSession`
+     * with `{ initialMessage, idempotencyKey }`, which `createSessionProxyHandler`
+     * accepts when the server supplies a `createSession` hook. Return the new id.
+     */
+    createSession?:
+      | ((initialMessage: string, idempotencyKey: string) => Promise<string>)
+      | undefined;
+    /** Hide the "New chat" entry point. */
+    newChat?: boolean | undefined;
+    /** Forwarded to the conversation (message rendering, tool renderers, composer...). */
+    conversationProps?: Omit<
+      SessionConversationProps,
+      "sessionId" | "client" | "workspaceId" | "baseUrl"
+    >;
+    /** Forwarded to the list (rename/archive toggles, page size). */
+    listProps?: Pick<SessionListProps, "rename" | "archive" | "pageSize"> | undefined;
+    labels?: Partial<OpenGeniChatLabels> | undefined;
+    className?: string | undefined;
+    /** Defaults to filling the host. */
+    height?: CSSProperties["height"];
+    /**
+     * Light or dark. Defaults to `auto`: follow the host page (an enclosing
+     * `data-og-theme`, `class="dark"`/`data-theme` on <html> or <body>, the
+     * host's `color-scheme`, then its background), not the OS setting alone.
+     */
+    theme?: HostThemePreference | undefined;
+    /**
+     * `host` (default) derives backgrounds and cards from the host background so
+     * the chat blends in; `theme` uses the `--og-color-*` surface tokens as they
+     * are. Customized surface tokens are always kept.
+     */
+    surface?: HostSurfacePreference | undefined;
+  };
 
 type CreateClient = Partial<Pick<OpenGeniClient, "createSession">>;
 
@@ -73,8 +80,20 @@ type CreateClient = Partial<Pick<OpenGeniClient, "createSession">>;
  * A complete chat experience: the user's chat list plus the conversation.
  * The list is a sidebar when the component is wide and a drawer when narrow
  * (container-based, so it adapts inside panels as well as full pages).
+ * `<OpenGeniChat baseUrl="/api/opengeni" />` needs no provider: it talks to
+ * your session proxy and uses the workspace the proxy resolves.
  */
-export function OpenGeniChat({
+export function OpenGeniChat({ baseUrl, ...props }: OpenGeniChatProps) {
+  if (baseUrl === undefined) return <Chat {...props} />;
+  const { client: _client, workspaceId, ...rest } = props;
+  return (
+    <SessionProxyScope baseUrl={baseUrl} workspaceId={workspaceId}>
+      <Chat {...rest} />
+    </SessionProxyScope>
+  );
+}
+
+function Chat({
   client,
   workspaceId,
   sessionId: controlledSessionId,
@@ -89,7 +108,7 @@ export function OpenGeniChat({
   height = "100%",
   theme,
   surface,
-}: OpenGeniChatProps) {
+}: Omit<OpenGeniChatProps, "baseUrl">) {
   const labels = { ...DEFAULT_LABELS, ...labelOverrides } as OpenGeniChatLabels;
   const scope = { client, workspaceId };
   const context = useOpenGeni(scope);

package/src/components/session-conversation.tsx

@@ -37,6 +37,7 @@ import {
 import type { UserMessageDisclosureLabels } from "./user-message-body";
 import { conversationTimeline } from "../conversation-timeline";
 import { cn } from "../lib/cn";
+import { SessionProxyScope, type SessionProxyBaseUrl } from "./session-proxy-scope";
 import { useErrorMessage } from "../lib/error-message";
 import {
   useHostTheme,
@@ -56,81 +57,94 @@ const DEFAULT_CONVERSATION_LABELS: SessionConversationLabels = {
   tryAgain: "Try again",
 };
 
-export type SessionConversationProps = ClientOverride & {
-  sessionId: string;
-  /** Host-owned artifact links, previews and other message presentation. */
-  renderMessageText?: MessageTimelineProps["renderMessageText"];
-  /**
-   * Open OpenGeni object links in agent replies (`artifact:`, `sandbox:`,
-   * editable artifacts, Sites). Asked first; by default retained files and
-   * sandbox files download only when the proxy explicitly enables them, while
-   * editable artifacts and Sites stay unavailable until the host resolves them.
-   */
-  resolveLink?: OpenGeniLinkResolver | undefined;
-  /**
-   * Open agent links to editable artifacts and Sites in a host viewer, for
-   * example `SessionArtifactViewer` mounted beside the conversation. Asked
-   * after `resolveLink`.
-   */
-  onOpenArtifact?: ((target: OpenGeniViewerTarget) => 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.
-   */
-  renderInteractiveBlock?: MessageTimelineProps["renderInteractiveBlock"] | false;
-  /** Product-specific tool-call renderers; defaults to the built-in registry. */
-  toolRegistry?: MessageTimelineProps["toolRegistry"];
-  /**
-   * Replace the "usage limit reached" row for an `allowance_exhausted`
-   * refusal, for example to link your own plan or admin page.
-   */
-  renderAllowanceExhausted?: MessageTimelineProps["renderAllowanceExhausted"];
-  /** Replace the words of the default "usage limit reached" row. */
-  allowanceExhaustedLabels?: MessageTimelineProps["allowanceExhaustedLabels"];
-  /**
-   * File attachments in the composer. Defaults to true; the attach control
-   * appears only when the deployment's client config enables file uploads.
-   */
-  attachments?: 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
-   * reports `modelSelection: true` (`createSessionProxyHandler({ modelSelection: true })`).
-   */
-  modelPicker?: boolean | undefined;
-  /** Model-picker appearance only; visibility, policy and delivery remain owned here. */
-  modelPickerProps?: Pick<ModelPolicyPickerProps, "groupPresentation" | "messages"> | undefined;
-  /** Localized actions for already-sent user-message disclosure. */
-  userMessageDisclosureLabels?: UserMessageDisclosureLabels | undefined;
-  loadSkillReview?: HumanInputSurfaceProps["loadSkillReview"];
-  className?: string;
-  /** Defaults to filling the host. The host owns available height. */
-  height?: CSSProperties["height"];
-  /**
-   * Light or dark. Defaults to `auto`: follow the host page (an enclosing
-   * `data-og-theme`, `class="dark"`/`data-theme` on <html> or <body>, the
-   * host's `color-scheme`, then its background), not the OS setting alone.
-   */
-  theme?: HostThemePreference | undefined;
-  /**
-   * `host` (default) derives backgrounds and cards from the host background so
-   * the conversation blends in; `theme` uses the `--og-color-*` surface tokens
-   * as they are. Customized surface tokens are always kept.
-   */
-  surface?: HostSurfacePreference | undefined;
-  /** Conversation-owned copy (error actions). */
-  labels?: Partial<SessionConversationLabels> | undefined;
-  /** Presentation/custom controls only; queue and delivery wiring stay owned here. */
-  composerProps?: Omit<
-    ChatComposerProps,
-    "composer" | "effectiveControl" | "queuedAheadCount" | "attachments"
-  >;
-};
+export type SessionConversationProps = ClientOverride &
+  SessionProxyBaseUrl & {
+    sessionId: string;
+    /** Host-owned artifact links, previews and other message presentation. */
+    renderMessageText?: MessageTimelineProps["renderMessageText"];
+    /**
+     * Open OpenGeni object links in agent replies (`artifact:`, `sandbox:`,
+     * editable artifacts, Sites). Asked first; by default retained files and
+     * sandbox files download only when the proxy explicitly enables them, while
+     * editable artifacts and Sites stay unavailable until the host resolves them.
+     */
+    resolveLink?: OpenGeniLinkResolver | undefined;
+    /**
+     * Open agent links to editable artifacts and Sites in a host viewer, for
+     * example `SessionArtifactViewer` mounted beside the conversation. Asked
+     * after `resolveLink`.
+     */
+    onOpenArtifact?: ((target: OpenGeniViewerTarget) => 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.
+     */
+    renderInteractiveBlock?: MessageTimelineProps["renderInteractiveBlock"] | false;
+    /** Product-specific tool-call renderers; defaults to the built-in registry. */
+    toolRegistry?: MessageTimelineProps["toolRegistry"];
+    /**
+     * Replace the "usage limit reached" row for an `allowance_exhausted`
+     * refusal, for example to link your own plan or admin page.
+     */
+    renderAllowanceExhausted?: MessageTimelineProps["renderAllowanceExhausted"];
+    /** Replace the words of the default "usage limit reached" row. */
+    allowanceExhaustedLabels?: MessageTimelineProps["allowanceExhaustedLabels"];
+    /**
+     * File attachments in the composer. Defaults to true; the attach control
+     * appears only when the deployment's client config enables file uploads.
+     */
+    attachments?: 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
+     * reports `modelSelection: true` (`createSessionProxyHandler({ modelSelection: true })`).
+     */
+    modelPicker?: boolean | undefined;
+    /** Model-picker appearance only; visibility, policy and delivery remain owned here. */
+    modelPickerProps?: Pick<ModelPolicyPickerProps, "groupPresentation" | "messages"> | undefined;
+    /** Localized actions for already-sent user-message disclosure. */
+    userMessageDisclosureLabels?: UserMessageDisclosureLabels | undefined;
+    loadSkillReview?: HumanInputSurfaceProps["loadSkillReview"];
+    className?: string;
+    /** Defaults to filling the host. The host owns available height. */
+    height?: CSSProperties["height"];
+    /**
+     * Light or dark. Defaults to `auto`: follow the host page (an enclosing
+     * `data-og-theme`, `class="dark"`/`data-theme` on <html> or <body>, the
+     * host's `color-scheme`, then its background), not the OS setting alone.
+     */
+    theme?: HostThemePreference | undefined;
+    /**
+     * `host` (default) derives backgrounds and cards from the host background so
+     * the conversation blends in; `theme` uses the `--og-color-*` surface tokens
+     * as they are. Customized surface tokens are always kept.
+     */
+    surface?: HostSurfacePreference | undefined;
+    /** Conversation-owned copy (error actions). */
+    labels?: Partial<SessionConversationLabels> | undefined;
+    /** Presentation/custom controls only; queue and delivery wiring stay owned here. */
+    composerProps?: Omit<
+      ChatComposerProps,
+      "composer" | "effectiveControl" | "queuedAheadCount" | "attachments"
+    >;
+  };
 
 /** Complete existing-session conversation. Uses the provider's normal SDK client
- * (including Site clients), one shared event feed, and authoritative queue state. */
-export function SessionConversation(props: SessionConversationProps) {
+ * (including Site clients), one shared event feed, and authoritative queue state.
+ * `<SessionConversation baseUrl="/api/opengeni" sessionId={id} />` needs no
+ * provider: it talks to your session proxy and its resolved workspace. */
+export function SessionConversation({ baseUrl, ...props }: SessionConversationProps) {
+  if (baseUrl === undefined) return <RetryingConversation {...props} />;
+  const { client: _client, workspaceId, ...rest } = props;
+  return (
+    <SessionProxyScope baseUrl={baseUrl} workspaceId={workspaceId}>
+      <RetryingConversation {...rest} />
+    </SessionProxyScope>
+  );
+}
+
+function RetryingConversation(props: Omit<SessionConversationProps, "baseUrl">) {
   // A failed initial load retries by remounting the whole conversation.
   const [attempt, setAttempt] = useState(0);
   return (

package/src/components/session-proxy-scope.tsx

@@ -0,0 +1,92 @@
+import { OpenGeniBrowserClient } from "@opengeni/sdk/browser";
+import { useEffect, useMemo, useState, type ReactNode } from "react";
+import { OpenGeniProvider } from "../provider";
+
+export type SessionProxyBaseUrl = {
+  /**
+   * Mount path of your `createSessionProxyHandler` (for example
+   * `"/api/opengeni"`). The component then needs no `OpenGeniProvider`,
+   * client, or workspace id: it creates the browser client for that path and
+   * uses the workspace the proxy resolved for the signed-in user. An explicit
+   * `workspaceId` skips that lookup.
+   */
+  baseUrl?: string | undefined;
+};
+
+type ScopeState =
+  | { status: "loading" }
+  | { status: "ready"; workspaceId: string }
+  | { status: "error"; message: string };
+
+/**
+ * `OpenGeniProvider` for a same-origin session proxy, from its base URL alone.
+ * The proxy's client config names the resolved workspace, so the browser
+ * never handles an Opengeni id. Provider-based usage is unchanged.
+ */
+export function SessionProxyScope({
+  baseUrl,
+  workspaceId,
+  children,
+}: {
+  baseUrl: string;
+  workspaceId?: string | undefined;
+  children: ReactNode;
+}) {
+  // Version skew between this bundle and the server SDK is tolerated, as for
+  // any embedded host: the proxy reports its own contract revision.
+  const client = useMemo(
+    () => new OpenGeniBrowserClient({ baseUrl, apiContract: "compatible" }),
+    [baseUrl],
+  );
+  const [state, setState] = useState<ScopeState>(
+    workspaceId ? { status: "ready", workspaceId } : { status: "loading" },
+  );
+  useEffect(() => {
+    if (workspaceId) {
+      setState({ status: "ready", workspaceId });
+      return;
+    }
+    let active = true;
+    setState({ status: "loading" });
+    client.getClientConfig().then(
+      (config) => {
+        if (!active) return;
+        setState(
+          config.workspaceId
+            ? { status: "ready", workspaceId: config.workspaceId }
+            : {
+                status: "error",
+                message:
+                  "This server does not report its workspace. Update @opengeni/sdk on the server, or pass workspaceId.",
+              },
+        );
+      },
+      (error: unknown) => {
+        if (!active) return;
+        setState({
+          status: "error",
+          message: error instanceof Error ? error.message : "Could not load the conversation.",
+        });
+      },
+    );
+    return () => {
+      active = false;
+    };
+  }, [client, workspaceId]);
+
+  if (state.status === "error") {
+    return (
+      <div role="alert" className="og-root p-3 text-og-sm text-og-danger" data-og-proxy-error="">
+        {state.message}
+      </div>
+    );
+  }
+  if (state.status === "loading") {
+    return <div className="og-root" aria-busy="true" data-og-proxy-loading="" />;
+  }
+  return (
+    <OpenGeniProvider client={client} workspaceId={state.workspaceId}>
+      {children}
+    </OpenGeniProvider>
+  );
+}

package/src/hooks/use-session-background-commands.ts

@@ -27,7 +27,7 @@ export function useSessionBackgroundCommands(
     async (signal?: AbortSignal) => {
       if (!sessionId) return { commands: [] };
       if (!client.listSessionBackgroundCommands) {
-        throw new Error("The configured OpenGeni client does not support background commands");
+        throw new Error("The configured Opengeni client does not support background commands");
       }
       return await client.listSessionBackgroundCommands(workspaceId, sessionId, { signal });
     },
@@ -49,7 +49,7 @@ export function useSessionBackgroundCommands(
     async (commandId: string): Promise<void> => {
       if (!sessionId) return;
       if (!client.cancelSessionBackgroundCommand) {
-        throw new Error("The configured OpenGeni client does not support background commands");
+        throw new Error("The configured Opengeni client does not support background commands");
       }
       const ticket = generation.current;
       await client.cancelSessionBackgroundCommand(workspaceId, sessionId, commandId);

package/src/hooks/use-video-artifact-playback.ts

@@ -15,7 +15,7 @@ export function useVideoArtifactPlaybackLoader(
   return useMemo(
     () => async (artifactId: string, signal?: AbortSignal) => {
       if (typeof client.createVideoArtifactPlaybackSource !== "function") {
-        throw new Error("This OpenGeni host does not expose retained-video playback.");
+        throw new Error("This Opengeni host does not expose retained-video playback.");
       }
       return await client.createVideoArtifactPlaybackSource(
         workspaceId,

package/src/lib/host-theme.ts

@@ -310,8 +310,21 @@ export function resolveHostTheme(element: Element): ResolvedHostTheme {
   return "light";
 }
 
-function normalizeToken(value: string): string {
-  return value.trim().toLowerCase().replace(/\s+/g, " ");
+/**
+ * Canonical text for comparing a token value with the stock one. The
+ * published `compiled.css` is minified (`#333`, `oklch(.52 .16 22)`), so the
+ * same color must compare equal in short and long form; otherwise every stock
+ * token reads as a host customization and dark values leak into light themes.
+ */
+export function normalizeToken(value: string): string {
+  return value
+    .trim()
+    .toLowerCase()
+    .replace(/\s+/g, " ")
+    .replace(/#([\da-f])([\da-f])([\da-f])(?![\da-f])/g, "#$1$1$2$2$3$3")
+    .replace(/(^|[\s(,/])0+(\.\d)/g, "$1$2")
+    .replace(/(\.\d*?)0+(?=[\s),/%]|$)/g, "$1")
+    .replace(/\.(?=[\s),/%]|$)/g, "");
 }
 
 /**

package/src/model-policy.ts

@@ -228,7 +228,7 @@ function workspaceProviderPayerSummary(model: ClientModel): string {
   if (model.provider === "workspace-anthropic")
     return "Billed to the workspace Anthropic API account";
   if (model.provider === "workspace-claude-subscription")
-    return "Uses the workspace Claude subscription · no OpenGeni credits";
+    return "Uses the workspace Claude subscription · no Opengeni credits";
   if (model.provider === "workspace-openrouter") {
     return "Billed to the workspace OpenRouter account";
   }
@@ -242,7 +242,7 @@ function organizationProviderPayerSummary(model: ClientModel): string {
   if (model.provider === "organization-anthropic")
     return "Billed to the organization Anthropic API account";
   if (model.provider === "organization-claude-subscription")
-    return "Uses the connected Claude subscription · no OpenGeni credits";
+    return "Uses the connected Claude subscription · no Opengeni credits";
   if (model.provider === "organization-openrouter") {
     return "Billed to the organization OpenRouter account";
   }

package/src/session-context.ts

@@ -129,7 +129,7 @@ function useEmbeddedClientRefinement<TClient extends object>(
   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.",
+      "@opengeni/react: no Opengeni client/workspace available. Wrap the tree in <OpenGeniProvider> or pass { client, workspaceId } to the hook.",
     );
   }
   const methods = candidate as Record<string, unknown>;
@@ -164,7 +164,7 @@ export function useOpenGeni(override: ClientOverride = {}): OpenGeniContextValue
   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.",
+      "@opengeni/react: no Opengeni client/workspace available. Wrap the tree in <OpenGeniProvider> or pass { client, workspaceId } to the hook.",
     );
   }
   return {
@@ -423,7 +423,7 @@ export function useOpenGeniClient(
   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.",
+      "@opengeni/react: no Opengeni client available. Wrap the tree in <OpenGeniProvider> or pass { client } to the hook.",
     );
   }
   return client;

package/src/timeline/projection.ts

@@ -2163,6 +2163,15 @@ function groupReadableTurns(items: TimelineItem[]): TimelineGroup[] {
         foldedProse.add(message);
         group.work!.details.push({ kind: "item", item: message });
       }
+    } else {
+      // Live progress stays primary above the work row, and is also listed in
+      // the work history so an expanded disclosure reads like the settled one.
+      // The timeline folds the outside copies only while that disclosure is open.
+      for (const message of prose) {
+        if (message.phase === "final_answer" || message.text.includes("![")) continue;
+        group.work!.details.push({ kind: "item", item: message });
+        (group.work!.liveNoteIds ??= []).push(message.id);
+      }
     }
     // Preserve event chronology, not completion timestamps or activity kinds.
     group.work!.details.sort((a, b) => {

package/src/timeline/turn-summary.tsx

@@ -4,6 +4,7 @@ import {
   createContext,
   useContext,
   useEffect,
+  useLayoutEffect,
   useMemo,
   useRef,
   useState,
@@ -144,6 +145,8 @@ export type TurnSummaryStatus = Readonly<{
 }>;
 
 export type TurnSummaryProps = {
+  /** Reports the disclosure's actual open state on mount and on every change. */
+  onOpenStateChange?: ((open: boolean) => void) | undefined;
   /** The activity items in the turn (used only to compute the facet counts). */
   items: ActivityItem[];
   /**
@@ -226,6 +229,7 @@ export function TurnSummary({
   copyText,
   contextCompactionCount,
   status,
+  onOpenStateChange,
   children,
 }: TurnSummaryProps) {
   // An explicit `defaultOpen` always wins; otherwise an ancestor may seed it
@@ -247,6 +251,12 @@ export function TurnSummary({
   const initialSettle = Boolean(settleFold) && !restingOpen && remembered === undefined;
   const [settling, setSettling] = useState(initialSettle);
   const [open, setOpen] = useState(initialSettle ? true : restingOpen);
+  const reportOpen = useRef(onOpenStateChange);
+  reportOpen.current = onOpenStateChange;
+  // Before paint: a listener may need to start motion in the same frame.
+  useLayoutEffect(() => {
+    reportOpen.current?.(open);
+  }, [open]);
   const readerOwnsOpen = useRef(remembered !== undefined);
   useEffect(() => {
     // Readable work can produce primary media or fail after mounting. Reveal

package/src/timeline/types.ts

@@ -586,6 +586,12 @@ export type TimelineGroup =
         responseStartedAt?: string;
         waiting?: { label: string; since: string };
         details: TimelineGroup[];
+        /**
+         * While the turn is live, its progress notes stay readable above the
+         * work row and are also listed in `details`. These are their item ids,
+         * so an expanded work disclosure can fold the outside copies away.
+         */
+        liveNoteIds?: string[];
       };
     }
   | {