@opengeni/react 1.2.1-canary.37222965366001 → 1.3.0

package/dist/components/approval-surface.d.ts

@@ -1,15 +1,15 @@
 import { type ReactNode } from "react";
+import { type ToolActionReview } from "@opengeni/sdk";
 import type { PendingApproval } from "../approvals.js";
+import { type ToolReviewDetailsLoader } from "./tool-action-review.js";
 export type ApprovalSurfaceMessages = {
     title: string;
-    /** Screen-reader context for the decision; not shown visually. */
     description: string;
     approve: string;
     reject: string;
     approving: string;
     rejecting: string;
     formatToolName: (name: string) => string;
-    /** Toggle for the exact arguments when they are shown as readable fields. */
     showDetails?: string | undefined;
     hideDetails?: string | undefined;
 };
@@ -22,6 +22,12 @@ export type ApprovalSurfaceProps = {
     error?: string | Error | null | undefined;
     messages?: Partial<ApprovalSurfaceMessages> | undefined;
     renderApproval?: ((approval: PendingApproval) => ReactNode) | undefined;
+    /** Authenticated server facts; hosts need not import any web-app code. */
+    loadReview?: ((approval: PendingApproval) => Promise<ToolActionReview>) | undefined;
+    loadDetails?: ToolReviewDetailsLoader | undefined;
+    onViewDetails?: ((review: ToolActionReview, path: string) => void) | undefined;
+    selectedApprovalId?: string | null | undefined;
+    onSelectedApprovalChange?: ((id: string) => void) | undefined;
     className?: string | undefined;
 };
 export type ApprovalField = {
@@ -29,15 +35,7 @@ export type ApprovalField = {
     label: string;
     value: string;
 };
-/**
- * Readable fields for a flat argument object (scalars and short scalar lists).
- * Returns null when the arguments are nested, large, or not an object, so the
- * caller shows the exact JSON instead of a lossy summary.
- */
+/** @deprecated Prefer the versioned server review; retained for small custom renderers. */
 export declare function approvalArgumentFields(value: unknown): ApprovalField[] | null;
-/**
- * Host-neutral approval presentation backed by the native pending-approval
- * projection and control callbacks. It owns only presentation and duplicate
- * click fencing; OpenGeni remains the authority for approval state.
- */
-export declare function ApprovalSurface({ approvals, onApprove, onReject, responding, error, messages: overrides, renderApproval, className, }: ApprovalSurfaceProps): import("react").JSX.Element | null;
+/** Hosts provide decisions; this surface never mutates the approved payload. */
+export declare function ApprovalSurface({ approvals, onApprove, onReject, responding, error, messages: overrides, renderApproval, loadReview, loadDetails, onViewDetails, selectedApprovalId, onSelectedApprovalChange, className, }: ApprovalSurfaceProps): import("react").JSX.Element | null;

package/dist/components/open-geni-chat.d.ts

@@ -1,3 +1,4 @@
+import type { FileResourceRef, LatencyMode, ReasoningEffort } from "@opengeni/sdk";
 import { type CSSProperties } from "react";
 import { type HostSurfacePreference, type HostThemePreference } from "../lib/host-theme.js";
 import { type ClientOverride } from "../session-context.js";
@@ -13,6 +14,15 @@ export type OpenGeniChatLabels = SessionListLabels & {
     send: string;
     newChatUnavailable: string;
 };
+/** What the first message carries besides its text. */
+export type OpenGeniChatCreateOptions = {
+    /** Files attached in the new-chat composer. */
+    resources?: FileResourceRef[] | undefined;
+    /** Present only when the user changed it in the model picker. */
+    model?: string | undefined;
+    reasoningEffort?: ReasoningEffort | undefined;
+    latencyMode?: LatencyMode | undefined;
+};
 export type OpenGeniChatProps = ClientOverride & SessionProxyBaseUrl & {
     /** Controlled selection. `null` shows the new-chat composer. */
     sessionId?: string | null | undefined;
@@ -21,14 +31,19 @@ export type OpenGeniChatProps = ClientOverride & SessionProxyBaseUrl & {
     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.
+     * with `{ initialMessage, idempotencyKey }` plus the attached files and any
+     * model choice, which `createSessionProxyHandler` accepts when the server
+     * supplies a `createSession` hook. Return the new id.
      */
-    createSession?: ((initialMessage: string, idempotencyKey: string) => Promise<string>) | undefined;
+    createSession?: ((initialMessage: string, idempotencyKey: string, options: OpenGeniChatCreateOptions) => 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 conversation (message rendering, tool renderers,
+     * composer...). `attachments`, `modelPicker`, `modelPickerProps`, and
+     * `composerProps` also apply to the new-chat composer.
+     */
+    conversationProps?: Omit<SessionConversationProps, "sessionId" | "client" | "workspaceId" | "baseUrl" | "headers" | "fetch">;
     /** Forwarded to the list (rename/archive toggles, page size). */
     listProps?: Pick<SessionListProps, "rename" | "archive" | "pageSize"> | undefined;
     labels?: Partial<OpenGeniChatLabels> | undefined;
@@ -55,4 +70,4 @@ export type OpenGeniChatProps = ClientOverride & SessionProxyBaseUrl & {
  * `<OpenGeniChat baseUrl="/api/opengeni" />` needs no provider: it talks to
  * your session proxy and uses the workspace the proxy resolves.
  */
-export declare function OpenGeniChat({ baseUrl, ...props }: OpenGeniChatProps): import("react").JSX.Element;
+export declare function OpenGeniChat({ baseUrl, headers, fetch, ...props }: OpenGeniChatProps): import("react").JSX.Element;

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

@@ -1,3 +1,4 @@
+import { type ReasoningEffort } from "@opengeni/sdk";
 import { type CSSProperties } from "react";
 import { type ClientOverride } from "../session-context.js";
 import { type ModelPolicyPickerProps } from "./model-policy-picker.js";
@@ -86,4 +87,20 @@ 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;
+/** Deployment/proxy flags from the client config: uploads, and whether model choice is open. */
+export declare 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;
+};

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,20 @@
+import type { ToolActionReview, ToolReviewDetailsPage } from "@opengeni/sdk";
+export type ToolReviewDetailsLoader = (review: ToolActionReview, path: string, offset: number) => Promise<ToolReviewDetailsPage>;
+/** 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, }: {
+    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;
+}): 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, }: {
+    review: ToolActionReview;
+    path?: string;
+    load: ToolReviewDetailsLoader;
+    onBack: () => void;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,21 @@
+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;
+/** Recorded calls have details, never another decision button. */
+export declare function ToolReviewHistoryReceipt({ approvalId }: {
+    approvalId: string;
+}): import("react").JSX.Element | null;
+export {};

package/dist/index.d.ts

@@ -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";
@@ -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

@@ -72,6 +72,9 @@ import {
   StartupTimings,
   StatusDot,
   TimelineRow,
+  ToolActionReviewCard,
+  ToolActionReviewDetails,
+  ToolReviewHistoryProvider,
   TurnSummary,
   UserMessageBody,
   answersFromDrafts,
@@ -107,7 +110,7 @@ import {
   useWorkspaceSessions,
   userMessageLikelyNeedsDisclosure,
   v4aToGitFileDiff
-} from "./chunk-4OTO7KBK.js";
+} from "./chunk-PGSX7UCP.js";
 import {
   useThemeType
 } from "./chunk-UK4TINKT.js";
@@ -140,7 +143,7 @@ import {
   useSessionControl,
   useSessionEvents,
   useTurnQueue
-} from "./chunk-X34BSY2R.js";
+} from "./chunk-WWEUO2PL.js";
 import {
   buildTimeline,
   creditExhaustedFromEvents,
@@ -5019,6 +5022,9 @@ export {
   TermBlock,
   Thumbnail,
   TimelineRow,
+  ToolActionReviewCard,
+  ToolActionReviewDetails,
+  ToolReviewHistoryProvider,
   Tooltip,
   TooltipContent,
   TooltipProvider,