@opengeni/react 1.2.1-canary.37222965366001 → 1.4.0

package/dist/components/session-conversation.d.ts

@@ -1,7 +1,9 @@
+import { type ClientVoiceInputConfig } from "@opengeni/sdk";
 import { type CSSProperties } from "react";
 import { type ClientOverride } from "../session-context.js";
 import { type ModelPolicyPickerProps } from "./model-policy-picker.js";
 import { type ChatComposerProps } from "./chat-composer.js";
+import type { ComposerTranscriptionControlProps } from "./composer-transcription-control.js";
 import { type HumanInputSurfaceProps } from "./human-input-surface.js";
 import { type MessageTimelineProps } from "./message-timeline.js";
 import { type OpenGeniLinkResolver, type OpenGeniViewerTarget } from "./open-geni-links.js";
@@ -13,6 +15,8 @@ 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;
 };
 export type SessionConversationProps = ClientOverride & SessionProxyBaseUrl & {
     sessionId: string;
@@ -31,10 +35,17 @@ export type SessionConversationProps = ClientOverride & SessionProxyBaseUrl & {
      * 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. */
@@ -51,6 +62,12 @@ export type SessionConversationProps = ClientOverride & SessionProxyBaseUrl & {
      * 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
@@ -86,4 +103,10 @@ export type SessionConversationProps = ClientOverride & SessionProxyBaseUrl & {
  * (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 declare function SessionConversation({ baseUrl, ...props }: SessionConversationProps): import("react").JSX.Element;
+export declare function SessionConversation({ baseUrl, headers, fetch, ...props }: SessionConversationProps): import("react").JSX.Element;
+/**
+ * The composer microphone: shown when the deployment can transcribe, enabled
+ * once the workspace's voice-input setting allows it.
+ */
+export declare function useComposerTranscription(client: unknown, workspaceId: string, capability: ClientVoiceInputConfig | null): ComposerTranscriptionControlProps | null;
+export { useClientConfigFlags } from "../hooks/use-client-config-flags.js";

package/dist/components/session-list.d.ts

@@ -17,7 +17,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;

package/dist/components/session-proxy-scope.d.ts

@@ -1,21 +1,35 @@
+import { type FetchLike } from "@opengeni/sdk/browser";
 import { type ReactNode } from "react";
+import type { SessionClientLike } from "../client.js";
+/** Request headers for every proxy call: static, or computed per request. */
+export type SessionProxyHeaders = Record<string, string> | (() => Record<string, string>);
 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.
+     * `workspaceId` skips that lookup. A `client` you pass is used instead of
+     * the created one (point it at the same proxy).
      */
     baseUrl?: string | undefined;
+    /**
+     * `baseUrl` mode: headers added to every proxy request, for hosts that
+     * authenticate with a bearer token instead of cookies. A function is called
+     * per request, so it can return the current token.
+     */
+    headers?: SessionProxyHeaders | undefined;
+    /** `baseUrl` mode: custom fetch for every proxy request (async auth, retries). */
+    fetch?: FetchLike | undefined;
 };
 /**
  * `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 declare function SessionProxyScope({ baseUrl, workspaceId, children, }: {
+export declare function SessionProxyScope({ baseUrl, workspaceId, client: suppliedClient, headers, fetch, children, }: Omit<SessionProxyBaseUrl, "baseUrl"> & {
     baseUrl: string;
     workspaceId?: string | undefined;
+    client?: SessionClientLike | undefined;
     children: ReactNode;
 }): import("react").JSX.Element;

package/dist/components/tool-action-review.d.ts

@@ -0,0 +1,47 @@
+import { type HTMLAttributes, type ReactNode } from "react";
+import type { ToolActionReview, ToolReviewDetailsPage } from "@opengeni/sdk";
+export type ToolReviewDetailsLoader = (review: ToolActionReview, path: string, offset: number) => Promise<ToolReviewDetailsPage>;
+type Tone = "waiting" | "ok" | "failed" | "muted";
+/** Shown when an older request's saved values are gone: approval is impossible, decline is not. */
+export declare const UNRECOVERABLE_TEXT = "The details of this older request couldn't be recovered, so it can't be approved. Decline it to let the agent continue.";
+/** Card chrome shared by the review, its loading state and its load failure. */
+export declare function ToolReviewFrame({ tone, icon, eyebrow, title, titleId, subtitle, children, footer, bare, ...rest }: {
+    tone: Tone;
+    icon: ReactNode;
+    eyebrow: ReactNode;
+    title: ReactNode;
+    titleId?: string | undefined;
+    subtitle?: ReactNode;
+    children?: ReactNode;
+    footer?: ReactNode;
+    bare?: boolean | undefined;
+} & Omit<HTMLAttributes<HTMLElement>, "title">): import("react").JSX.Element;
+export declare function DeclineButton({ busy, submitting, label, onClick, }: {
+    busy: boolean;
+    submitting: boolean;
+    label?: string | undefined;
+    onClick: () => void;
+}): import("react").JSX.Element;
+/** One host-neutral review. All callbacks refer to the immutable action; none can edit it. */
+export declare function ToolActionReviewCard({ review, onApprove, onReject, submitting, disabled, onViewDetails, pendingLabel, rejectLabel, bare, }: {
+    review: ToolActionReview;
+    onApprove?: (() => void) | undefined;
+    onReject?: (() => void) | undefined;
+    submitting?: "approve" | "reject" | null | undefined;
+    disabled?: boolean | undefined;
+    onViewDetails?: ((path: string) => void) | undefined;
+    pendingLabel?: string | undefined;
+    rejectLabel?: string | undefined;
+    /** Render without card chrome, e.g. inside an expanded timeline row. */
+    bare?: boolean | undefined;
+}): import("react").JSX.Element;
+/** Full-page detail content: hosts choose navigation, never a nested scrolling panel. */
+export declare function ToolActionReviewDetails({ review, path: initialPath, load, onBack, manageFocus, }: {
+    review: ToolActionReview;
+    path?: string;
+    load: ToolReviewDetailsLoader;
+    onBack: () => void;
+    /** Hosts rendering simultaneous previews can retain their own focus. */
+    manageFocus?: boolean;
+}): import("react").JSX.Element;
+export {};

package/dist/components/tool-review-history.d.ts

@@ -0,0 +1,25 @@
+import { type ReactNode } from "react";
+import type { SessionEvent, ToolActionReview } from "@opengeni/sdk";
+type HistoryContext = {
+    approvalIds: ReadonlySet<string>;
+    revision: number;
+    load: (approvalId: string) => Promise<ToolActionReview>;
+    onViewDetails: (review: ToolActionReview, path: string) => void;
+};
+/** Opt-in, authenticated history for the exact reviewed calls in the visible event window. */
+export declare function ToolReviewHistoryProvider({ events, load, onViewDetails, children, }: {
+    events: readonly SessionEvent[];
+    load: HistoryContext["load"];
+    onViewDetails: HistoryContext["onViewDetails"];
+    children: ReactNode;
+}): import("react").JSX.Element;
+export declare function useHasToolReview(approvalId: string | null): boolean;
+/**
+ * The saved review for one recorded call, or null while it loads or when it is
+ * unavailable (callers then keep their ordinary tool row).
+ */
+export declare function useRecordedToolReview(approvalId: string | null): {
+    review: ToolActionReview | null;
+    onViewDetails: ((path: string) => void) | undefined;
+};
+export {};

package/dist/composer.js

@@ -41,7 +41,7 @@ import {
   useChatComposer,
   useChatComposerController,
   useVoiceInput
-} from "./chunk-CY7WK5FD.js";
+} from "./chunk-LN6TCXD3.js";
 import "./chunk-RSI7XYXL.js";
 import "./chunk-BRM6FVZA.js";
 import {

package/dist/connect.js

@@ -3,7 +3,7 @@ import {
   McpConnectionCard,
   mcpConnectionDiscoveryState,
   useConnect
-} from "./chunk-TMYGL6X5.js";
+} from "./chunk-MBMPHOMA.js";
 import {
   Markdown
 } from "./chunk-I7IWRQLN.js";

package/dist/hooks/use-client-config-flags.d.ts

@@ -0,0 +1,37 @@
+import type { ClientVoiceInputConfig, ReasoningEffort } from "@opengeni/sdk";
+/** The client-config fields the stock conversation and chat read. */
+export type ClientConfigFlagsSource = {
+    getClientConfig: () => Promise<{
+        fileUploads?: {
+            enabled?: boolean;
+        };
+        modelSelection?: boolean | undefined;
+        sandboxFiles?: boolean | undefined;
+        defaultReasoningEffort?: ReasoningEffort | undefined;
+        artifacts?: unknown;
+        sessionCreation?: boolean | undefined;
+        archive?: boolean | undefined;
+        voiceInput?: ClientVoiceInputConfig | undefined;
+    }>;
+};
+export type ClientConfigFlags = {
+    /** Whether the config has loaded. Proxy capability flags stay `true` until it says otherwise. */
+    loaded: boolean;
+    uploads: boolean;
+    modelSelection: boolean;
+    sandboxFiles: boolean;
+    defaultReasoningEffort: ReasoningEffort | null;
+    /**
+     * Inline Site previews and the artifact viewer. `false` only when a session
+     * proxy says it does not serve them; native deployments omit the flag.
+     */
+    artifacts: boolean;
+    /** Browser chat creation. `false` only when a session proxy has no `createSession` hook. */
+    sessionCreation: boolean;
+    /** Chat archive/restore. `false` only when a session proxy disables it. */
+    archive: boolean;
+    /** Native voice input when the deployment can transcribe, else null. */
+    voiceInput: ClientVoiceInputConfig | null;
+};
+/** Deployment and session-proxy capabilities from the client config. */
+export declare function useClientConfigFlags(client: Partial<ClientConfigFlagsSource> | ClientConfigFlagsSource): ClientConfigFlags;

package/dist/index.d.ts

@@ -2,7 +2,7 @@ export { sessionAuthRecommendation } from "./session-auth-recommendation.js";
 export { SessionConnectionRequest, type SessionConnectionRequestProps, } from "./components/session-connection-request.js";
 export { SessionMcpCapabilityCard, McpConnectionCard, type McpConnectionCardProps, type SessionMcpCapabilityCardProps, } from "./components/session-mcp-capability-card.js";
 export { SessionCapabilityFrame, type SessionCapabilityFrameProps, } from "./components/session-capability-frame.js";
-export { attachSessionCapability, completeSessionCapabilityOAuth, } from "./session-capability-policy.js";
+export { attachSessionCapability, completeSessionCapabilityOAuth, prepareSessionCapabilityAccess, applySessionCapabilityAccess, type SessionCapabilityAccessPlan, } from "./session-capability-policy.js";
 export { retainedImageId } from "./components/markdown.js";
 export type { EmbeddedBrowserInteractionClientLike, EmbeddedComputerInteractionClientLike, EmbeddedFileAttachmentClientLike, EmbeddedGoalClientLike, EmbeddedHumanInputSessionClientLike, EmbeddedInteractionClientLike, EmbeddedSessionEventClientLike, EmbeddedSessionLineageClientLike, EmbeddedSessionMcpApprovalPolicyClientLike, EmbeddedSessionReadClientLike, EmbeddedSessionClientLike, SessionClientLike, } from "./client.js";
 export { OpenGeniProvider } from "./provider.js";
@@ -91,6 +91,8 @@ export type { DeriveMachineChipInput, MachineChip, MachineChipState, UseMachineC
 export { approvalsFromRequiresAction, projectPendingApprovals } from "./approvals.js";
 export type { PendingApproval } from "./approvals.js";
 export { ApprovalSurface, defaultApprovalSurfaceMessages } from "./components/approval-surface.js";
+export { ToolActionReviewCard, ToolActionReviewDetails } from "./components/tool-action-review.js";
+export type { ToolReviewDetailsLoader } from "./components/tool-action-review.js";
 export type { ApprovalSurfaceMessages, ApprovalSurfaceProps } from "./components/approval-surface.js";
 export { humanInputRequestFromEvent, projectPendingHumanInputRequests } from "./human-input.js";
 export type { PendingHumanInputRequest } from "./human-input.js";
@@ -102,8 +104,8 @@ export { HumanInputSurface } from "./components/human-input-surface.js";
 export type { HumanInputSurfaceProps } from "./components/human-input-surface.js";
 export { buildTimeline, creditExhaustedFromEvents, extractSessionRef, groupTimeline, sessionStatusFromEvents, toolDisplayName, } from "./timeline/index.js";
 export type { GroupTimelineOptions, ActivityItem, AgentMessageItem, AuthNeededItem, ContextCompactionItem, GoalItem, HumanInputAnswerSummary, HumanInputItem, MachineInputBatchItem, MachineInputMember, NoticeItem, ReasoningItem, SandboxItem, SessionStatusItem, TimelineGroup, TimelineItem, TurnEndItem, ToolCallItem, UserMessageItem, WorkerItem, } from "./timeline/index.js";
-export { createDefaultToolRegistry, createToolRegistry, defaultToolRegistry, rawTypeOf, } from "./timeline/index.js";
-export type { CreateToolRegistryOptions, RetainedArtifactLoader, RetainedScreenshotLoader, VideoArtifactPlaybackLoader, ToolRegistry, ToolRegistryEntry, ToolRenderer, ToolRendererProps, } from "./timeline/index.js";
+export { createDefaultToolRegistry, createSessionRetainedScreenshotLoader, createToolRegistry, createWorkspaceRetainedArtifactLoader, createWorkspaceRetainedVideoLoader, defaultToolRegistry, rawTypeOf, } from "./timeline/index.js";
+export type { CreateToolRegistryOptions, RetainedArtifactLoader, RetainedArtifactLoaderClient, RetainedScreenshotLoader, RetainedScreenshotLoaderClient, RetainedVideoLoaderClient, VideoArtifactPlaybackLoader, ToolRegistry, ToolRegistryEntry, ToolRenderer, ToolRendererProps, } from "./timeline/index.js";
 export { ActivityDisclosure, ActivityRail, BodyNote, DisclosureDefaultsProvider, LightboxProvider, MediaEmpty, MediaSkeleton, PayloadBlock, ScreenshotFigure, TermBlock, Thumbnail, TurnSummary, BUILT_IN_TURN_SUMMARY_FACET_IDS, useLightbox, useLightboxOptional, } from "./timeline/index.js";
 export type { ActivityDisclosureProps, ActivityRailProps, DisclosureChip, BuiltInTurnSummaryFacetId, TurnOutcome, TurnSummaryContext, TurnSummaryFacet, TurnSummaryFacetConfiguration, TurnSummaryFacetResult, TurnSummaryOptions, TurnSummaryProps, TurnSummaryStatus, LightboxControlLabels, } from "./timeline/index.js";
 export { applyPatchOps, applyPatchOpsFromToolItem, controlCaret, execTruncated, isApplyPatch, isExecSessionLostBanner, looksBinary, parseExecBannerSessionId, parseFreeformApplyPatch, parseToolArgs, sandboxCommandExitCode, stripExecBanner, tailPeek, unwrapMcpOutput, v4aToGitFileDiff, } from "./timeline/index.js";
@@ -121,7 +123,7 @@ export { SessionConversation } from "./components/session-conversation.js";
 export { SessionList } from "./components/session-list.js";
 export type { SessionListLabels, SessionListProps } from "./components/session-list.js";
 export { OpenGeniChat } from "./components/open-geni-chat.js";
-export type { OpenGeniChatLabels, OpenGeniChatProps } from "./components/open-geni-chat.js";
+export type { OpenGeniChatCreateOptions, OpenGeniChatLabels, OpenGeniChatProps, } from "./components/open-geni-chat.js";
 export type { SessionConversationLabels, SessionConversationProps, } from "./components/session-conversation.js";
 export type { ChatComposerProps } from "./components/chat-composer.js";
 export { ComposerTranscriptionControl } from "./components/composer-transcription-control.js";
@@ -203,3 +205,4 @@ export { ClaudeMark } from "./components/claude-mark.js";
 export { AnthropicMark } from "./components/anthropic-mark.js";
 export { OpenRouterMark } from "./components/openrouter-mark.js";
 export { GrokMark } from "./components/grok-mark.js";
+export { ToolReviewHistoryProvider } from "./components/tool-review-history.js";

package/dist/index.js

@@ -11,13 +11,11 @@ import {
 } from "./chunk-YM2DE7BQ.js";
 import {
   createEmbeddedSessionClient,
-  isGoalEvent,
   isLineageRefreshEvent,
   isSessionMcpApprovalPolicyEvent,
-  useGoal,
   useSessionLineage,
   useSessionMcpApprovalPolicy
-} from "./chunk-742CZ3L3.js";
+} from "./chunk-H5X55XH7.js";
 import {
   CONNECTION_STATUS_META,
   ConnectionDot,
@@ -72,6 +70,9 @@ import {
   StartupTimings,
   StatusDot,
   TimelineRow,
+  ToolActionReviewCard,
+  ToolActionReviewDetails,
+  ToolReviewHistoryProvider,
   TurnSummary,
   UserMessageBody,
   answersFromDrafts,
@@ -79,7 +80,10 @@ import {
   applyPatchOpsFromToolItem,
   controlCaret,
   createDefaultToolRegistry,
+  createSessionRetainedScreenshotLoader,
   createToolRegistry,
+  createWorkspaceRetainedArtifactLoader,
+  createWorkspaceRetainedVideoLoader,
   defaultApprovalSurfaceMessages,
   defaultHumanInputFormMessages,
   defaultToolRegistry,
@@ -107,14 +111,14 @@ import {
   useWorkspaceSessions,
   userMessageLikelyNeedsDisclosure,
   v4aToGitFileDiff
-} from "./chunk-4OTO7KBK.js";
+} from "./chunk-LJ2UTJJE.js";
 import {
   useThemeType
 } from "./chunk-UK4TINKT.js";
 import "./chunk-J2QWVSQY.js";
 import "./chunk-C5X5AJXK.js";
 import "./chunk-ZYRGEKWS.js";
-import "./chunk-FZCP527Y.js";
+import "./chunk-CJUO7J5Z.js";
 import {
   ArtifactLabelsProvider,
   DEFAULT_ARTIFACT_LABELS
@@ -129,28 +133,30 @@ import {
   conversationTimeline,
   createOlderHistoryLoadReceipt,
   humanInputRequestFromEvent,
+  isGoalEvent,
   isHumanInputEvent,
   isTitleEvent,
   isTurnQueueEvent,
   projectPendingApprovals,
   projectPendingHumanInputRequests,
   useFileAttachments,
+  useGoal,
   useHumanInputRequests,
   useSession,
   useSessionControl,
   useSessionEvents,
   useTurnQueue
-} from "./chunk-X34BSY2R.js";
+} from "./chunk-WZMYFJD3.js";
 import {
   buildTimeline,
   creditExhaustedFromEvents,
   extractSessionRef,
   groupTimeline,
   sessionStatusFromEvents
-} from "./chunk-RC6BZ44Q.js";
+} from "./chunk-OA6HFRQP.js";
 import {
   toolDisplayName
-} from "./chunk-ERGYJIBB.js";
+} from "./chunk-AWZLIMKX.js";
 import {
   OpenGeniProvider
 } from "./chunk-3CTRFMAK.js";
@@ -158,9 +164,11 @@ import {
   McpConnectionCard,
   SessionCapabilityFrame,
   SessionMcpCapabilityCard,
+  applySessionCapabilityAccess,
   attachSessionCapability,
-  completeSessionCapabilityOAuth
-} from "./chunk-TMYGL6X5.js";
+  completeSessionCapabilityOAuth,
+  prepareSessionCapabilityAccess
+} from "./chunk-MBMPHOMA.js";
 import {
   ActivityDisclosure,
   BodyNote,
@@ -235,7 +243,7 @@ import {
   useSlashCommands,
   useTranscription,
   useVoiceInput
-} from "./chunk-CY7WK5FD.js";
+} from "./chunk-LN6TCXD3.js";
 import {
   FILE_ONLY_MESSAGE_TEXT,
   composeSendInput,
@@ -5019,6 +5027,9 @@ export {
   TermBlock,
   Thumbnail,
   TimelineRow,
+  ToolActionReviewCard,
+  ToolActionReviewDetails,
+  ToolReviewHistoryProvider,
   Tooltip,
   TooltipContent,
   TooltipProvider,
@@ -5048,6 +5059,7 @@ export {
   appendFinalTranscript,
   applyPatchOps,
   applyPatchOpsFromToolItem,
+  applySessionCapabilityAccess,
   approvalsFromRequiresAction,
   argHint,
   attachSessionCapability,
@@ -5069,8 +5081,11 @@ export {
   createDefaultToolRegistry,
   createEmbeddedSessionClient,
   createOlderHistoryLoadReceipt,
+  createSessionRetainedScreenshotLoader,
   createToolRegistry,
   createVoiceRecordingManifest,
+  createWorkspaceRetainedArtifactLoader,
+  createWorkspaceRetainedVideoLoader,
   creditExhaustedFromEvents,
   defaultApprovalSurfaceMessages,
   defaultChatComposerMessages,
@@ -5132,6 +5147,7 @@ export {
   payerSummaryForModel,
   planVoiceRecordingChunkCommit,
   pointsFor,
+  prepareSessionCapabilityAccess,
   prepareVoiceRecordingChunk,
   presentFailure,
   projectClientModelRows,