@opengeni/react 3.1.0 → 3.1.2

package/src/index.ts

@@ -1,3 +1,26 @@
+export { sessionAuthRecommendation } from "./session-auth-recommendation";
+export {
+  SessionConnectionRequest,
+  type SessionConnectionRequestProps,
+} from "./components/session-connection-request";
+export {
+  SessionMcpCapabilityCard,
+  McpConnectionCard,
+  type McpConnectionCardProps,
+  type SessionMcpCapabilityCardProps,
+} from "./components/session-mcp-capability-card";
+export {
+  SessionCapabilityFrame,
+  type SessionCapabilityFrameProps,
+} from "./components/session-capability-frame";
+export {
+  attachSessionCapability,
+  completeSessionCapabilityOAuth,
+  prepareSessionCapabilityAccess,
+  applySessionCapabilityAccess,
+  type SessionCapabilityAccessPlan,
+} from "./session-capability-policy";
+export { retainedImageId } from "./components/markdown";
 // oxlint-disable-next-line typescript/triple-slash-reference -- package consumers must load the ambient type for this optional untyped peer without emitting a runtime import.
 /// <reference path="./types/external.d.ts" />
 
@@ -23,7 +46,7 @@ export type {
   SessionClientLike,
 } from "./client";
 export { OpenGeniProvider } from "./provider";
-export type { OpenGeniProviderProps } from "./provider";
+export type { OpenGeniProviderProps, ErrorMessageFormatter } from "./provider";
 export { useOpenGeni, useOpenGeniClient } from "./session-context";
 export { useVideoArtifactPlaybackLoader } from "./hooks/use-video-artifact-playback";
 export type { ClientOverride, OpenGeniContextValue } from "./session-context";
@@ -48,7 +71,6 @@ export {
   SESSION_EVENT_BROWSER_MAX_COUNT,
   SESSION_EVENT_BROWSER_PENDING_MAX_BYTES,
   SESSION_EVENT_BROWSER_PENDING_MAX_COUNT,
-  SESSION_EVENT_BROWSER_SINGLE_EVENT_MAX_BYTES,
   boundBrowserSessionEventWindow,
   useSessionEvents,
 } from "./hooks/use-session-events";
@@ -70,6 +92,7 @@ export {
 export type {
   ComposerControllerState,
   ComposerPolicy,
+  InitialComposerDraft,
   ComposerSendExtras,
   ComposerState,
   UseComposerOptions,
@@ -111,7 +134,14 @@ export type {
   VoiceRecordingTranscriptionState,
   VoiceRecordingUploadState,
 } from "./voice-recording-store";
-export { COMPOSER_PAYMENT_REQUIRED_MESSAGE, composerSubmissionErrorMessage } from "./lib/format";
+export {
+  COMPOSER_MODEL_UNAVAILABLE_MESSAGE,
+  COMPOSER_PAYMENT_REQUIRED_MESSAGE,
+  COMPOSER_SESSION_USAGE_LIMIT_MESSAGE,
+  composerSubmissionErrorMessage,
+  isModelUnavailableSubmissionError,
+  isSessionUsageLimitSubmissionError,
+} from "./lib/format";
 export {
   INITIAL_TRANSCRIPTION_CONTROL_STATE,
   appendFinalTranscript,
@@ -197,13 +227,78 @@ export type {
   UseSessionLineageOptions,
   UseSessionLineageResult,
 } from "./hooks/use-session-lineage";
-export { useVariableSets, useEnvironments } from "./hooks/use-environments";
-export type {
-  UseVariableSetsOptions,
-  UseVariableSetsResult,
-  UseEnvironmentsOptions,
-  UseEnvironmentsResult,
-} from "./hooks/use-environments";
+export {
+  useVaultsApi,
+  useVaults,
+  useVault,
+  useVaultItems,
+  useVaultItem,
+  useVaultFieldVersions,
+  useSessionSecrets,
+  VAULT_ITEM_PAGE_LIMIT,
+} from "./hooks/use-vaults";
+export type { UseVaultQueryOptions } from "./hooks/use-vaults";
+export { asVaultClient, vaultsApi, vaultErrorCode, vaultErrorDetail } from "@opengeni/sdk";
+export type { VaultClientLike, VaultsApi } from "@opengeni/sdk";
+export type {
+  VaultPolicy,
+  VaultOwnerKind,
+  VaultSource,
+  VaultMode,
+  VaultSyncStatus,
+  VaultItemType,
+  VaultFieldKind,
+  VaultAvailability,
+  VaultSummary,
+  VaultItemReferences,
+  VaultItemSummary,
+  VaultItemField,
+  PasskeySummary,
+  VaultItem,
+  VaultVersionCreatedByKind,
+  VaultFieldVersionMeta,
+  GeneratePasswordOptions,
+  CreateVaultRequest,
+  UpdateVaultRequest,
+  VaultFieldInput,
+  CreateVaultItemRequest,
+  UpdateVaultItemRequest,
+  MoveVaultItemRequest,
+  RevealVaultFieldResponse,
+  ListVaultItemsQuery,
+  SessionSecretsVault,
+  SessionSecretsView,
+  OnePasswordPlanTier,
+  InstallOnePasswordRequest,
+  ProviderVaultMeta,
+  InstallOnePasswordResponse,
+  OnePasswordConnectionSummary,
+  ReplaceOnePasswordTokenRequest,
+  DisconnectOnePasswordResponse,
+  LinkProviderVaultRequest,
+  CreateManagedProviderVaultRequest,
+  VaultErrorCode,
+} from "@opengeni/sdk";
+export { SecretsUiProvider, useSecretsUi } from "./secrets-ui";
+export {
+  SecretAnswerChip,
+  SecretRefChip,
+  SecretRefText,
+  secretReferenceLabel,
+} from "./components/secret-ref-chip";
+export type {
+  SecretAnswerChipProps,
+  SecretRefChipProps,
+  SecretRefTextProps,
+  SecretReferenceLabel,
+} from "./components/secret-ref-chip";
+export type {
+  SecretsUi,
+  SecretReferenceLike,
+  SecretReferenceTargetLike,
+  SecretTextTokenLike,
+  PasswordStrengthLike,
+} from "./secrets-ui";
 export { useChannels } from "./hooks/use-channels";
 export type { UseChannelsOptions, UseChannelsResult } from "./hooks/use-channels";
 export { useRigs, useRig, useRigVersions, useRigChanges } from "./hooks/use-rigs";
@@ -217,8 +312,6 @@ export type {
   UseRigChangesOptions,
   UseRigChangesResult,
 } from "./hooks/use-rigs";
-export { usePacks } from "./hooks/use-packs";
-export type { UsePacksOptions, UsePacksResult } from "./hooks/use-packs";
 export { useWorkspaces } from "./hooks/use-workspaces";
 export type { UseWorkspacesOptions, UseWorkspacesResult } from "./hooks/use-workspaces";
 export { useBillingUsage } from "./hooks/use-billing-usage";
@@ -306,6 +399,8 @@ export type {
 export { approvalsFromRequiresAction, projectPendingApprovals } from "./approvals";
 export type { PendingApproval } from "./approvals";
 export { ApprovalSurface, defaultApprovalSurfaceMessages } from "./components/approval-surface";
+export { ToolActionReviewCard, ToolActionReviewDetails } from "./components/tool-action-review";
+export type { ToolReviewDetailsLoader } from "./components/tool-action-review";
 export type { ApprovalSurfaceMessages, ApprovalSurfaceProps } from "./components/approval-surface";
 
 // Structured human input: event projection, authoritative hook, and styled form.
@@ -339,6 +434,7 @@ export {
   toolDisplayName,
 } from "./timeline";
 export type {
+  GroupTimelineOptions,
   ActivityItem,
   AgentMessageItem,
   AuthNeededItem,
@@ -352,6 +448,7 @@ export type {
   ReasoningItem,
   SandboxItem,
   SessionStatusItem,
+  SessionUsageLimitStop,
   TimelineGroup,
   TimelineItem,
   TurnEndItem,
@@ -363,14 +460,21 @@ export type {
 // Tool-renderer registry + the per-tool renderers (the timeline's extension API)
 export {
   createDefaultToolRegistry,
+  createSessionRetainedScreenshotLoader,
   createToolRegistry,
+  createWorkspaceRetainedArtifactLoader,
+  createWorkspaceRetainedVideoLoader,
   defaultToolRegistry,
   rawTypeOf,
 } from "./timeline";
 export type {
   CreateToolRegistryOptions,
   RetainedArtifactLoader,
+  RetainedArtifactLoadOptions,
+  RetainedArtifactLoaderClient,
   RetainedScreenshotLoader,
+  RetainedScreenshotLoaderClient,
+  RetainedVideoLoaderClient,
   VideoArtifactPlaybackLoader,
   ToolRegistry,
   ToolRegistryEntry,
@@ -394,6 +498,7 @@ export {
   TurnSummary,
   BUILT_IN_TURN_SUMMARY_FACET_IDS,
   useLightbox,
+  useLightboxGalleryItem,
   useLightboxOptional,
 } from "./timeline";
 export type {
@@ -408,7 +513,10 @@ export type {
   TurnSummaryFacetResult,
   TurnSummaryOptions,
   TurnSummaryProps,
+  TurnSummaryStatus,
   LightboxControlLabels,
+  LightboxGalleryEntry,
+  LightboxGalleryImage,
 } from "./timeline";
 
 // Pure provider-shape parsers (exec banner, V4A diff, tool arguments, …)
@@ -462,6 +570,39 @@ export type { CommandPaletteProps } from "./components/command-palette";
 
 // Components
 export { ChatComposer } from "./components/chat-composer";
+export { conversationTimeline } from "./conversation-timeline";
+export { SessionConversation, SessionConversationView } from "./components/session-conversation";
+export { useSessionConversation } from "./hooks/use-session-conversation";
+export { useNewConversation } from "./hooks/use-new-conversation";
+export type {
+  NewConversationController,
+  UseNewConversationOptions,
+  NewConversationCreateOptions,
+  CreatedConversation,
+} from "./hooks/use-new-conversation";
+export { NewConversation, NewConversationView } from "./components/new-conversation";
+export type {
+  NewConversationProps,
+  NewConversationViewProps,
+  NewConversationLabels,
+} from "./components/new-conversation";
+export type {
+  SessionConversationController,
+  UseSessionConversationOptions,
+} from "./hooks/use-session-conversation";
+export { SessionList } from "./components/session-list";
+export type { SessionListLabels, SessionListProps } from "./components/session-list";
+export { OpenGeniChat } from "./components/open-geni-chat";
+export type {
+  OpenGeniChatCreateOptions,
+  OpenGeniChatLabels,
+  OpenGeniChatProps,
+} from "./components/open-geni-chat";
+export type {
+  SessionConversationLabels,
+  SessionConversationProps,
+  SessionConversationViewProps,
+} from "./components/session-conversation";
 export type { ChatComposerProps } from "./components/chat-composer";
 export { ComposerTranscriptionControl } from "./components/composer-transcription-control";
 export type {
@@ -475,15 +616,16 @@ export type { ModelPickerProps } from "./components/model-picker";
 export {
   BillingClassMark,
   ModelPolicyPicker,
-  ModelPolicyPickerMenu,
   PickerAnimatedPage,
   PickerBackHeader,
   PickerNavRow,
   defaultModelPolicyPickerMessages,
 } from "./components/model-policy-picker";
+export { ModelPolicyPickerMenu } from "./components/model-policy-picker-menu";
 export type {
   ModelPolicyPickerMessages,
   ModelPolicyPickerProps,
+  ModelPolicyPickerGroupPresentation,
 } from "./components/model-policy-picker";
 export {
   advancedSourceSummary,
@@ -498,27 +640,76 @@ export {
   labelLatencyMode,
   labelReasoningEffort,
   payerSummaryForModel,
+  modelUsesCredits,
   projectClientModelRows,
   projectPickerRows,
   runnableLatencyModesForModel,
   sortPickerRows,
 } from "./model-policy";
-export type { LatencyModeId, PickerBillingClass, PickerModelRow } from "./model-policy";
+export type {
+  GroupPickerRowsOptions,
+  LatencyModeId,
+  PickerBillingClass,
+  PickerModelRow,
+} from "./model-policy";
+export { ChatGptMark, ModelMark, ModelName, modelHasMark } from "./components/model-mark";
+export {
+  humanizeModelSlug,
+  isRawModelLabel,
+  modelDisplayName,
+  modelSlug,
+  modelVendor,
+} from "@opengeni/sdk/model-display";
+export type { ModelDisplayInput, ModelVendor } from "@opengeni/sdk/model-display";
 export { MessageTimeline, TimelineRow } from "./components/message-timeline";
 export { GeneratedVideoPlayer } from "./components/generated-video-player";
 export type { GeneratedVideoPlayerProps } from "./components/generated-video-player";
 export type { MessageTimelineProps } from "./components/message-timeline";
+export { MessageSenderLabel } from "./timeline/message-sender";
+export type { RenderMessageSender } from "./timeline/message-sender";
+export type { MessageSender } from "./timeline";
+export type { RenderAllowanceExhausted } from "./timeline/allowance-exhausted-row";
+export type { AllowanceLabels, AllowanceScope } from "./usage/allowance-copy";
+export type { TimelineSearchTarget } from "./components/timeline-search";
 export { UserMessageBody, userMessageLikelyNeedsDisclosure } from "./components/user-message-body";
-export type { UserMessageBodyProps } from "./components/user-message-body";
+export type {
+  UserMessageBodyProps,
+  UserMessageDisclosureLabels,
+} from "./components/user-message-body";
 export {
   Markdown,
   sandboxFileLocationFromHref,
   sandboxFilePathFromHref,
 } from "./components/markdown";
-export type { MarkdownProps, SandboxFileLocation } from "./components/markdown";
+export type {
+  MarkdownProps,
+  MarkdownInteractiveBlock,
+  SandboxFileLocation,
+} from "./components/markdown";
+export {
+  OpenGeniLinkProvider,
+  chainLinkResolvers,
+  sessionLinkResolver,
+  useOpenGeniLinkResolver,
+  viewerLinkResolver,
+} from "./components/open-geni-links";
+export type {
+  OpenGeniLinkResolution,
+  OpenGeniLinkResolver,
+  OpenGeniLinkTarget,
+  OpenGeniViewerTarget,
+} from "./components/open-geni-links";
+export { parseOpenGeniLink } from "@opengeni/sdk";
+export {
+  ArtifactLabelsProvider,
+  DEFAULT_ARTIFACT_LABELS,
+  type ArtifactLabels,
+} from "./components/artifacts/artifact-chrome";
 export { CopyButton, CopyHoverFrame } from "./components/copy-button";
 export { copyTextToClipboard, tableElementToTsv } from "./lib/clipboard";
 export { SessionStatus, StatusDot, SESSION_STATUS_META } from "./components/session-status";
+export { sessionAdmissionBlocked, sessionDisplayStatus } from "./session-status-model";
+export type { SessionDisplayStatus } from "./session-status-model";
 export type {
   SessionStatusProps,
   StatusDotProps,
@@ -537,6 +728,22 @@ export type { WorkbenchChangesProps } from "./components/workbench-changes";
 export { DiffView } from "./components/diff-view";
 export type { DiffViewProps, DiffTheme } from "./components/diff-view";
 export { PierreDiff } from "./components/pierre-diff";
+// Opt in to the optional `@pierre/diffs` peer with `enablePierreDiffs()` from
+// `@opengeni/react/diffs`; the root entry never names the peer.
+export { registerPierreDiffs, type PierreDiffsLoader } from "./lib/pierre-diffs-loader";
+// Bundler-visible optional workbench imports live only on opt-in subpaths.
+export {
+  registerSandboxTerminal,
+  registerCodeEditor,
+  registerDesktopViewer,
+} from "./lib/workbench-peers";
+export type {
+  WorkbenchPeerLoader,
+  SandboxTerminalPeers,
+  CodeEditorPeers,
+  CodeEditorLanguage,
+  CodeEditorLanguages,
+} from "./lib/workbench-peers";
 export type { PierreDiffProps } from "./components/pierre-diff";
 export { PierreFile } from "./components/pierre-file";
 export type { PierreFileProps } from "./components/pierre-file";
@@ -581,6 +788,13 @@ export type {
   UseCodexAccountsOptions,
   UseCodexAccountsResult,
 } from "./hooks/use-codex-accounts";
+// Model-account choice for every provider on the shared subscription core.
+export { useSessionModelAccount, isModelAccountEvent } from "./hooks/use-session-model-account";
+export type {
+  ModelAccountClientLike,
+  UseSessionModelAccountOptions,
+  UseSessionModelAccountResult,
+} from "./hooks/use-session-model-account";
 export { useSuperGrokAccounts } from "./hooks/use-supergrok-accounts";
 export type {
   SuperGrokAccountsClientLike,
@@ -594,14 +808,46 @@ export { xtermThemeFromTokens } from "./lib/xterm-theme";
 
 // Utilities
 export { cn } from "./lib/cn";
+export { markClassicScrollbars } from "./lib/scrollbars";
 export {
   CREDIT_EXHAUSTION_MESSAGE,
   formatBytes,
   formatClockTime,
   formatRelativeTime,
   humanizeFailureReason,
+  presentFailure,
   isCreditExhaustion,
   stringifyPayload,
   truncate,
   tryParseJson,
 } from "./lib/format";
+export {
+  currentProviderRecovery,
+  parseProviderRecovery,
+  providerRecoveryExhaustedText,
+  providerRecoveryRetryingText,
+  providerRecoverySubject,
+  type ProviderRecoveryCondition,
+  type ProviderRecoveryFacts,
+} from "./lib/provider-recovery";
+export {
+  ProviderRecoveryNotice,
+  PROVIDER_RECOVERY_NOTICE_DETAIL,
+  type ProviderRecoveryNoticeProps,
+} from "./components/provider-recovery-notice";
+export { SessionCommandsPanel } from "./components/session-commands-panel";
+export { SessionCommands } from "./components/session-commands";
+
+export { KnowledgeActivityProvider } from "./timeline/knowledge-receipt";
+export type { KnowledgeActivityActions } from "./timeline/knowledge-receipt";
+
+export { StartupTimings } from "./timeline/startup-timings";
+export { setStartupDetails, useStartupDetails } from "./timeline/startup-preference";
+
+export { ClaudeMark } from "./components/claude-mark";
+export { AnthropicMark } from "./components/anthropic-mark";
+export { OpenRouterMark } from "./components/openrouter-mark";
+export { OpperMark } from "./components/opper-mark";
+export { GrokMark } from "./components/grok-mark";
+
+export { ToolReviewHistoryProvider } from "./components/tool-review-history";

package/src/interaction.ts

@@ -58,6 +58,7 @@ export type {
 } from "./hooks/use-browser-identities";
 export { useBrowserSession } from "./hooks/use-browser-session";
 export type {
+  BrowserInputFailure,
   UseBrowserSessionOptions,
   UseBrowserSessionResult,
 } from "./hooks/use-browser-session";

package/src/lib/clipboard.ts

@@ -35,6 +35,35 @@ export async function copyTextToClipboard(text: string): Promise<boolean> {
   }
 }
 
+/**
+ * Copy text that is still being prepared, such as a command around a freshly
+ * minted URL. Safari only allows a clipboard write during the click itself, so
+ * hand the pending text to a `ClipboardItem` where supported; otherwise wait
+ * for it and copy. Resolves false when the text failed or nothing was copied.
+ */
+export async function copyPendingTextToClipboard(text: Promise<string>): Promise<boolean> {
+  if (
+    typeof ClipboardItem !== "undefined" &&
+    typeof navigator !== "undefined" &&
+    typeof navigator.clipboard?.write === "function"
+  ) {
+    const blob = text.then((value) => new Blob([value], { type: "text/plain" }));
+    // The caller observes a failed `text`; never leave this copy unhandled.
+    blob.catch(() => {});
+    try {
+      await navigator.clipboard.write([new ClipboardItem({ "text/plain": blob })]);
+      return true;
+    } catch {
+      // Fall through: some browsers reject promised clipboard items.
+    }
+  }
+  try {
+    return await copyTextToClipboard(await text);
+  } catch {
+    return false;
+  }
+}
+
 /** Serialize an HTML table to tab-separated values (spreadsheet-friendly). */
 export function tableElementToTsv(table: HTMLTableElement | null | undefined): string {
   if (!table) {

package/src/lib/error-message.ts

@@ -0,0 +1,37 @@
+import { formatErrorMessage } from "@opengeni/sdk";
+import { createContext, useCallback, useContext, useRef } from "react";
+
+/** Original diagnostic error and the library's neutral, state-aware display copy. */
+export type ErrorMessageFormatter = (error: unknown, defaultMessage: string) => string | undefined;
+
+export const ErrorMessageContext = createContext<ErrorMessageFormatter | undefined>(undefined);
+
+const originalCauses = new WeakMap<Error, unknown>();
+
+/** Keep existing Error-typed state while retaining non-Error rejections privately. */
+export function normalizeError(cause: unknown): Error {
+  if (cause instanceof Error) return cause;
+  const error = new Error(String(cause));
+  originalCauses.set(error, cause);
+  return error;
+}
+
+/** Presentation only: callers retain their errors and delivery/retry state. */
+export function useErrorMessage(): (error: unknown, defaultMessage?: string) => string {
+  const formatter = useContext(ErrorMessageContext);
+  const formatterRef = useRef(formatter);
+  formatterRef.current = formatter;
+  return useCallback((error, fallback) => {
+    const original =
+      error instanceof Error && originalCauses.has(error) ? originalCauses.get(error) : error;
+    const defaultMessage = fallback ?? formatErrorMessage(original);
+    try {
+      const message = formatterRef.current?.(original, defaultMessage);
+      return typeof message === "string" && message ? message : defaultMessage;
+    } catch {
+      // Host presentation must never interrupt delivery-state settlement or
+      // cause an already-started mutation to be retried.
+      return defaultMessage;
+    }
+  }, []);
+}