@opengeni/react 1.0.1 → 1.0.2-canary.37191796234001

package/src/index.ts

@@ -1,3 +1,23 @@
+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,
+} 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,11 +43,22 @@ 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";
+export { createEmbeddedSessionClient } from "./embedded-session-client";
+export type {
+  ComposerDraftMapContext,
+  CreateEmbeddedSessionClientOptions,
+} from "./embedded-session-client";
 export { usePageLiveActivity } from "./hooks/internal";
+export { filePathVisibility, visibleFileTree } from "./file-node-visibility";
+export type {
+  FileNodeVisibilityContext,
+  FileNodeVisibilityPredicate,
+  FilePathVisibility,
+} from "./file-node-visibility";
 
 // Hooks
 export { useSession, isTitleEvent } from "./hooks/use-session";
@@ -37,16 +68,17 @@ 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";
+export { createOlderHistoryLoadReceipt } from "./older-history";
 export type {
   BrowserSessionEventWindow,
   SessionEventsConnectionState,
   UseSessionEventsOptions,
   UseSessionEventsResult,
 } from "./hooks/use-session-events";
+export type { OlderHistoryLoader, OlderHistoryLoadReceipt } from "./older-history";
 export {
   useComposer,
   composeSendInput,
@@ -54,7 +86,13 @@ export {
   shouldSubmitOnKey,
   FILE_ONLY_MESSAGE_TEXT,
 } from "./hooks/use-composer";
-export type { ComposerSendExtras, ComposerState, UseComposerOptions } from "./hooks/use-composer";
+export type {
+  ComposerControllerState,
+  ComposerPolicy,
+  ComposerSendExtras,
+  ComposerState,
+  UseComposerOptions,
+} from "./hooks/use-composer";
 export {
   VOICE_RECORDING_CLIENT_MAX_DURATION_SECONDS,
   VOICE_RECORDING_OWNER_HEARTBEAT_MILLISECONDS,
@@ -92,7 +130,12 @@ 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,
+  composerSubmissionErrorMessage,
+  isModelUnavailableSubmissionError,
+} from "./lib/format";
 export {
   INITIAL_TRANSCRIPTION_CONTROL_STATE,
   appendFinalTranscript,
@@ -129,7 +172,12 @@ export type {
 } from "./hooks/use-last-started-turn-policy";
 export { QueueSurface } from "./components/queue-surface";
 export type { QueueSurfaceProps } from "./components/queue-surface";
-export { SessionChrome, sessionChromeGoalPillState } from "./components/session-chrome";
+export {
+  SessionChrome,
+  sessionChromeGoalPillExplanation,
+  sessionChromeGoalPillLabel,
+  sessionChromeGoalPillState,
+} from "./components/session-chrome";
 export type {
   SessionChromeAgentsSignal,
   SessionChromeProps,
@@ -163,6 +211,11 @@ export type {
   UseWorkspaceSessionsOptions,
   UseWorkspaceSessionsResult,
 } from "./hooks/use-workspace-sessions";
+export { useSessionBackgroundCommands } from "./hooks/use-session-background-commands";
+export type {
+  UseSessionBackgroundCommandsOptions,
+  UseSessionBackgroundCommandsResult,
+} from "./hooks/use-session-background-commands";
 export { useSessionLineage, isLineageRefreshEvent } from "./hooks/use-session-lineage";
 export type {
   UseSessionLineageOptions,
@@ -188,8 +241,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";
@@ -310,11 +361,14 @@ export {
   toolDisplayName,
 } from "./timeline";
 export type {
+  GroupTimelineOptions,
   ActivityItem,
   AgentMessageItem,
   AuthNeededItem,
   ContextCompactionItem,
   GoalItem,
+  HumanInputAnswerSummary,
+  HumanInputItem,
   MachineInputBatchItem,
   MachineInputMember,
   NoticeItem,
@@ -377,6 +431,8 @@ export type {
   TurnSummaryFacetResult,
   TurnSummaryOptions,
   TurnSummaryProps,
+  TurnSummaryStatus,
+  LightboxControlLabels,
 } from "./timeline";
 
 // Pure provider-shape parsers (exec banner, V4A diff, tool arguments, …)
@@ -430,6 +486,16 @@ export type { CommandPaletteProps } from "./components/command-palette";
 
 // Components
 export { ChatComposer } from "./components/chat-composer";
+export { conversationTimeline } from "./conversation-timeline";
+export { SessionConversation } from "./components/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 { OpenGeniChatLabels, OpenGeniChatProps } from "./components/open-geni-chat";
+export type {
+  SessionConversationLabels,
+  SessionConversationProps,
+} from "./components/session-conversation";
 export type { ChatComposerProps } from "./components/chat-composer";
 export { ComposerTranscriptionControl } from "./components/composer-transcription-control";
 export type {
@@ -443,15 +509,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,
@@ -466,22 +533,70 @@ 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 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 { Markdown } from "./components/markdown";
+export type {
+  UserMessageBodyProps,
+  UserMessageDisclosureLabels,
+} from "./components/user-message-body";
+export {
+  Markdown,
+  sandboxFileLocationFromHref,
+  sandboxFilePathFromHref,
+} 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 type { MarkdownProps } from "./components/markdown";
 export { SessionStatus, StatusDot, SESSION_STATUS_META } from "./components/session-status";
 export type {
   SessionStatusProps,
@@ -501,6 +616,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";
@@ -564,8 +695,22 @@ export {
   formatClockTime,
   formatRelativeTime,
   humanizeFailureReason,
+  presentFailure,
   isCreditExhaustion,
   stringifyPayload,
   truncate,
   tryParseJson,
 } from "./lib/format";
+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 { GrokMark } from "./components/grok-mark";

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/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;
+    }
+  }, []);
+}

package/src/lib/format.ts

@@ -1,4 +1,11 @@
-import { OpenGeniApiError } from "@opengeni/sdk";
+import { formatErrorMessage, OpenGeniApiError } from "@opengeni/sdk";
+
+const clockTimeFormatter = new Intl.DateTimeFormat(undefined, {
+  month: "short",
+  day: "numeric",
+  hour: "numeric",
+  minute: "2-digit",
+});
 
 /** Local finished-at stamp for message footers: "Aug 2, 3:42 PM" / locale-equivalent. */
 export function formatClockTime(iso: string): string {
@@ -6,12 +13,7 @@ export function formatClockTime(iso: string): string {
   if (Number.isNaN(then.getTime())) {
     return "";
   }
-  return then.toLocaleString(undefined, {
-    month: "short",
-    day: "numeric",
-    hour: "numeric",
-    minute: "2-digit",
-  });
+  return clockTimeFormatter.format(then);
 }
 
 /** Compact relative time: "now", "42s", "7m", "3h", "2d", then a date. */
@@ -107,7 +109,13 @@ export function tryParseJson(text: string): unknown {
  * workspace no longer has.
  */
 export const CREDIT_EXHAUSTION_MESSAGE =
-  "Out of OpenGeni credits — this workspace's balance is empty. Add credits to continue; the conversation is preserved.";
+  "Out of credits — this workspace's balance is empty. Add credits to continue; the conversation is preserved.";
+
+/** A usage ceiling refused the send; the default allowance wording, plus what is safe. */
+export const COMPOSER_MEMBER_ALLOWANCE_MESSAGE =
+  "Usage limit reached. A workspace admin can raise this limit. Your draft is preserved.";
+export const COMPOSER_WORKSPACE_ALLOWANCE_MESSAGE =
+  "Workspace usage limit reached. An organization admin can raise the workspace budget. Your draft is preserved.";
 
 /**
  * Actionable composer copy for an edge rejection before a turn is accepted.
@@ -115,14 +123,98 @@ export const CREDIT_EXHAUSTION_MESSAGE =
  * actor-private draft or any finalized attachment.
  */
 export const COMPOSER_PAYMENT_REQUIRED_MESSAGE =
-  "This turn requires OpenGeni managed credits, but the account balance is empty. Add credits or choose a connected Codex subscription model, then retry. Your draft and attachments are preserved.";
+  "Your organization doesn't have enough credits to send this message. Add credits or choose a model with another payment source. Your message and attachments are saved.";
+
+/** Trusted, composer-owned guidance; unlike remote diagnostic prose, this is UI copy. */
+export class ComposerStateError extends Error {}
+
+/** A restored request has omitted credentials and must be reconciled, not replayed. */
+export class ComposerReconciliationRequiredError extends ComposerStateError {
+  constructor() {
+    super(
+      "Opengeni cannot safely retry this uncertain request after remount; reconcile the session before sending again.",
+    );
+  }
+}
+
+export class ComposerWorkspaceControlUnavailableError extends Error {
+  constructor() {
+    super("@opengeni/react: workspace-scoped resume requires setWorkspaceInferenceState.");
+  }
+}
+
+/**
+ * The send named a model that is no longer in the live catalog (retired or
+ * removed). Retrying the same send cannot succeed; the person must choose
+ * another model, and the typed message stays recoverable via Edit message.
+ */
+export const COMPOSER_MODEL_UNAVAILABLE_MESSAGE =
+  "This chat's model is no longer available. Choose another model to continue. Your message is saved.";
+
+/** `details.code` the API sets on a 422 for a model missing from the live catalog. */
+export const MODEL_UNAVAILABLE_DETAIL_CODE = "model_unavailable";
+
+/**
+ * Is this send refusal "the model is no longer available"? Reads the typed
+ * `details.code`, and also the historical message so a refusal persisted
+ * before a reload (only its text survives) or from an older API is recognized.
+ */
+export function isModelUnavailableSubmissionError(error: Error): boolean {
+  if (error instanceof OpenGeniApiError && error.details?.code === MODEL_UNAVAILABLE_DETAIL_CODE) {
+    return true;
+  }
+  return (
+    error.message === COMPOSER_MODEL_UNAVAILABLE_MESSAGE ||
+    /^OpenGeni API 422: model is not available: /.test(error.message)
+  );
+}
 
 export function composerSubmissionErrorMessage(error: Error): string {
-  return error instanceof OpenGeniApiError &&
-    error.status === 402 &&
-    error.code === "payment_required"
-    ? COMPOSER_PAYMENT_REQUIRED_MESSAGE
-    : error.message;
+  if (error instanceof ComposerReconciliationRequiredError) {
+    return "This client cannot safely retry this uncertain request after remount; reconcile the session before sending again.";
+  }
+  if (error instanceof ComposerWorkspaceControlUnavailableError) {
+    return "This client cannot resume the workspace. Ask your administrator for a control-capable client.";
+  }
+  if (error instanceof ComposerStateError) return error.message;
+  if (error instanceof OpenGeniApiError && error.outcomeUnknown) return formatErrorMessage(error);
+  if (isModelUnavailableSubmissionError(error)) return COMPOSER_MODEL_UNAVAILABLE_MESSAGE;
+  if (error instanceof OpenGeniApiError && error.code === "allowance_exhausted") {
+    // OpenGeniAllowanceExhaustedError carries the scope; read it structurally
+    // so this startup-path helper adds no SDK or wording imports.
+    const message =
+      (error as { scope?: unknown }).scope === "workspace"
+        ? COMPOSER_WORKSPACE_ALLOWANCE_MESSAGE
+        : COMPOSER_MEMBER_ALLOWANCE_MESSAGE;
+    return composerErrorReference(error, message);
+  }
+  return isComposerCreditRefusal(error)
+    ? composerErrorReference(error, COMPOSER_PAYMENT_REQUIRED_MESSAGE)
+    : formatErrorMessage(error);
+}
+
+function composerErrorReference(error: Error, message: string): string {
+  return error instanceof OpenGeniApiError && error.correlationId
+    ? `${message} Reference: ${error.correlationId}.`
+    : message;
+}
+
+/** These definitive refusals need a payment, allowance or model change, not an unchanged retry. */
+export function composerSubmissionCanRetry(error: Error): boolean {
+  return !(
+    isComposerCreditRefusal(error) ||
+    isModelUnavailableSubmissionError(error) ||
+    (error instanceof OpenGeniApiError && error.code === "allowance_exhausted")
+  );
+}
+
+function isComposerCreditRefusal(error: Error): boolean {
+  return (
+    (error instanceof OpenGeniApiError &&
+      error.status === 402 &&
+      (error.code === "payment_required" || error.code === "insufficient_credits")) ||
+    isCreditExhaustion(error.message)
+  );
 }
 
 /**
@@ -184,3 +276,47 @@ export function humanizeFailureReason(reason: string | null): string | null {
   }
   return reason;
 }
+
+/** Project failure diagnostics without changing the stored event, including legacy retry wrappers. */
+export function presentFailure(payload: Record<string, unknown>): {
+  reason: string | null;
+  safetyRefusal: boolean;
+} {
+  const databaseFailure =
+    payload.code === "db_deadlock" ||
+    payload.code === "db_serialization_failure" ||
+    payload.code === "db_failure" ||
+    (typeof payload.sqlState === "string" &&
+      /^[0-9A-Z]{5}$/.test(payload.sqlState) &&
+      payload.database !== null &&
+      typeof payload.database === "object" &&
+      !Array.isArray(payload.database));
+  if (databaseFailure) {
+    return { reason: "The service encountered a database error.", safetyRefusal: false };
+  }
+  const text = (key: string): string | null => {
+    const value = payload[key];
+    return typeof value === "string" && value.trim() ? value : null;
+  };
+  const message = text("error") ?? text("message");
+  const detail = text("lastRetryableError") ?? text("detail");
+  const safetyRefusal =
+    payload.code === "provider_safety_refusal" ||
+    [message, detail].some(
+      (value) =>
+        value !== null && /\bthis request was blocked by our safety systems\b/i.test(value),
+    );
+  if (safetyRefusal) {
+    return {
+      reason: `The model provider blocked this request.${detail || message ? ` ${detail ?? message}` : ""}`,
+      safetyRefusal: true,
+    };
+  }
+  return {
+    reason:
+      detail && detail !== message
+        ? [humanizeFailureReason(message), humanizeFailureReason(detail)].filter(Boolean).join(" ")
+        : humanizeFailureReason(message),
+    safetyRefusal: false,
+  };
+}