@opengeni/react 3.1.0 → 3.1.2

package/src/approvals.ts

@@ -1,4 +1,8 @@
-import type { SessionEvent } from "@opengeni/sdk";
+import {
+  parseToolDisplayMetadata,
+  type ToolDisplayMetadata,
+  type SessionEvent,
+} from "@opengeni/sdk";
 
 /* ----------------------------------------------------------------------------
    Pending-approvals projection
@@ -26,6 +30,7 @@ export type PendingApproval = {
   id: string;
   /** Tool/function name awaiting the decision. */
   name: string;
+  display?: ToolDisplayMetadata;
   arguments?: unknown;
   /** The raw approval entry from the `session.requiresAction` payload. */
   raw?: unknown;
@@ -49,11 +54,13 @@ export function approvalsFromRequiresAction(payload: unknown): PendingApproval[]
       raw.rawItem && typeof raw.rawItem === "object"
         ? (raw.rawItem as Record<string, unknown>)
         : {};
+    const display = parseToolDisplayMetadata(raw.display);
     return {
       // Mirror the runtime's canonical interruption identity before retaining
       // the legacy top-level callId fallback for already-normalized payloads.
       id: String(rawItem.callId ?? rawItem.id ?? raw.id ?? raw.callId ?? raw.name ?? index),
       name: String(raw.name ?? raw.toolName ?? rawItem.name ?? "approval"),
+      ...(display ? { display } : {}),
       arguments: raw.arguments ?? rawItem.arguments,
       raw: approval,
     };

package/src/artifacts-spreadsheet.ts

@@ -5,6 +5,7 @@ export {
   SpreadsheetProjectionGrid,
   type SpreadsheetArtifactSurfaceProps,
   type SpreadsheetCommit,
+  type SpreadsheetDimensionCommit,
   type SpreadsheetRangeCommit,
   type SpreadsheetGridProps,
   type SpreadsheetGridProjection,

package/src/artifacts.ts

@@ -1,3 +1,43 @@
+export { inlineHtmlDocument } from "./components/artifacts/inline-html-document";
+export { isRetainedImageContentType, useRetainedImageObjectUrl } from "./timeline/retained-image";
+export { PatchApplyCommand, isPatchFilename } from "./timeline/patch-apply-command";
+export {
+  ArtifactBadge,
+  ArtifactLabelsProvider,
+  DEFAULT_ARTIFACT_LABELS,
+  useArtifactLabels,
+  type ArtifactLabels,
+  ArtifactButton,
+  ArtifactLoading,
+  ArtifactProblem,
+  ArtifactSelect,
+  ArtifactViewerHeader,
+  artifactKindIcon,
+  artifactKindSubtitle,
+  artifactLoadErrorMessage,
+  artifactLoadErrorView,
+  type ArtifactKind,
+  type ArtifactLoadErrorKind,
+  type ArtifactLoadErrorView,
+  ArtifactSandbox,
+  type ArtifactSandboxProps,
+  DeferredChatMedia,
+  SiteView,
+  type SiteViewProps,
+  ChatInteractiveBlock,
+  type ChatInteractiveBlockProps,
+  type SiteSnapshotClient,
+  type SiteToolBridgeFactory,
+  type SiteToolScope,
+  EditableArtifactView,
+  type EditableArtifactRuntimes,
+  type EditableArtifactViewProps,
+  type OpenedEditableArtifact,
+  SessionArtifactViewer,
+  type SessionArtifactTarget,
+  type SessionArtifactViewerLabels,
+  type SessionArtifactViewerProps,
+} from "./components/artifacts";
 /** Public artifact surfaces. Import from `@opengeni/react/artifacts`. */
 export {
   ArtifactSurface,
@@ -18,6 +58,8 @@ export {
   PresentationProjectionEditor,
   PublishedHtmlArtifactFrame,
   PUBLISHED_HTML_ARTIFACT_IFRAME_SANDBOX,
+  openGeniSiteBridgePortFromBootstrap,
+  publishedHtmlArtifactDocument,
   SpreadsheetArtifactSurface,
   SpreadsheetGrid,
   SpreadsheetProjectionGrid,
@@ -62,6 +104,7 @@ export {
   type PresentationProjectionConnector,
   type PresentationProjectionEditorProps,
   type PublishedHtmlArtifactFrameProps,
+  type PublishedHtmlArtifactToolBridge,
   type PresentationProjectionElementMetadata,
   type PresentationProjectionElement,
   type PresentationProjectionFill,
@@ -79,6 +122,7 @@ export {
   type PresentationSlideProjection,
   type SpreadsheetArtifactSurfaceProps,
   type SpreadsheetCommit,
+  type SpreadsheetDimensionCommit,
   type SpreadsheetRangeCommit,
   type SpreadsheetGridProps,
   type SpreadsheetGridProjection,

package/src/assets/README.md

@@ -0,0 +1,8 @@
+# Service marks
+
+These provider-owned marks identify the connected service; they do not imply endorsement.
+
+- `gmail.ico`: existing Gmail service mark.
+- `outlook.ico`: https://outlook.live.com/favicon.ico (retrieved 2026-09-20).
+
+The React package bundles these assets so embedding hosts do not need matching public paths or make third-party image requests for these marks.

package/src/capability-catalog-row.tsx

@@ -0,0 +1,94 @@
+import type { ComponentPropsWithoutRef, ReactNode } from "react";
+import { AlertTriangleIcon, CheckIcon, Loader2Icon, PlusIcon } from "lucide-react";
+
+export type CapabilityCatalogStatus =
+  | "available"
+  | "added"
+  | "attention"
+  | "unavailable"
+  | "loading";
+
+export type CapabilityCatalogRowProps = Omit<
+  ComponentPropsWithoutRef<"button">,
+  "children" | "onClick" | "name"
+> & {
+  name: string;
+  description?: string | undefined;
+  icon?: ReactNode;
+  status?: CapabilityCatalogStatus;
+  statusLabel?: string | undefined;
+  /** Preserve opaque host status text when adopting this row without typed health. */
+  showStatusLabel?: boolean;
+  onOpen: () => void;
+};
+
+const labels: Record<CapabilityCatalogStatus, string> = {
+  available: "Available to add",
+  added: "Added",
+  attention: "Needs attention",
+  unavailable: "Unavailable",
+  loading: "Working",
+};
+
+/** A display-only state. The entire catalog row is the action, never this glyph. */
+export function CapabilityCatalogIndicator({
+  status = "available",
+  label,
+  showLabel = false,
+}: {
+  status?: CapabilityCatalogStatus;
+  label?: string | undefined;
+  showLabel?: boolean;
+}) {
+  const Icon =
+    status === "added"
+      ? CheckIcon
+      : status === "attention" || status === "unavailable"
+        ? AlertTriangleIcon
+        : status === "loading"
+          ? Loader2Icon
+          : PlusIcon;
+  return (
+    <span className="og-capability-catalog-indicator" data-status={status}>
+      <Icon aria-hidden="true" />
+      <span
+        className={
+          showLabel || status === "attention" || status === "unavailable"
+            ? "og-capability-catalog-notice"
+            : "og-capability-catalog-sr-only"
+        }
+      >
+        {label ?? labels[status]}
+      </span>
+    </span>
+  );
+}
+
+/** Shared by connections, skills, and plugins: one row, one focus target, one action. */
+export function CapabilityCatalogRow({
+  name,
+  description,
+  icon,
+  status = "available",
+  statusLabel,
+  showStatusLabel = false,
+  onOpen,
+  className = "",
+  ...props
+}: CapabilityCatalogRowProps) {
+  return (
+    <button
+      {...props}
+      type="button"
+      className={`og-capability-catalog-row ${className}`}
+      onClick={onOpen}
+    >
+      {icon ? <span className="og-capability-catalog-icon">{icon}</span> : null}
+      <span className="og-capability-catalog-copy">
+        <strong>{name}</strong>
+        {description ? <span>{description}</span> : null}
+      </span>
+      <CapabilityCatalogIndicator status={status} label={statusLabel} showLabel={showStatusLabel} />
+    </button>
+  );
+}

package/src/capability-logo-fallback.ts

@@ -0,0 +1,22 @@
+import type { CapabilityCatalogItem } from "@opengeni/sdk";
+import gmailLogo from "./assets/gmail.ico";
+
+/** Passive catalogue identity, shared by embedded and console surfaces. */
+export function capabilityLogoFallback(
+  item: Pick<CapabilityCatalogItem, "id"> &
+    Partial<Pick<CapabilityCatalogItem, "metadata" | "mcpUrl">>,
+): string | null {
+  if (
+    item.id.startsWith("mcp:integrations-sh:gmailmcp-googleapis-com-") ||
+    item.mcpUrl === "https://gmailmcp.googleapis.com/mcp/v1"
+  )
+    return gmailLogo;
+  const original = item.metadata?.originalLogoUrl;
+  if (typeof original !== "string") return null;
+  try {
+    const url = new URL(original);
+    return url.protocol === "https:" || url.protocol === "http:" ? url.href : null;
+  } catch {
+    return null;
+  }
+}

package/src/client.ts

@@ -5,7 +5,7 @@ import type { OpenGeniClient } from "@opengeni/sdk";
  * pass the real SDK client, a proxy-backed client that routes through their
  * own API, or a scripted client in tests/demos.
  */
-export type SessionClientLike = Pick<
+type SessionClientMethods = Pick<
   OpenGeniClient,
   // Deployment config (host-exposed models, auth, upload limits)
   | "getClientConfig"
@@ -49,20 +49,6 @@ export type SessionClientLike = Pick<
   | "uploadFile"
   | "getFile"
   | "createFileDownloadUrl"
-  // VariableSets
-  | "listVariableSets"
-  | "getVariableSetVariable"
-  | "createVariableSet"
-  | "updateVariableSet"
-  | "deleteVariableSet"
-  | "setVariableSetVariable"
-  | "deleteVariableSetVariable"
-  | "listEnvironments"
-  | "createEnvironment"
-  | "updateEnvironment"
-  | "deleteEnvironment"
-  | "setEnvironmentVariable"
-  | "deleteEnvironmentVariable"
   // Channels (rail organization)
   | "listChannels"
   | "createChannel"
@@ -84,15 +70,6 @@ export type SessionClientLike = Pick<
   | "verifyRigChange"
   | "promoteRigChange"
   | "verifyRig"
-  // Packs
-  | "listPacks"
-  | "registerPack"
-  | "enablePack"
-  | "previewPackInstallation"
-  | "installPack"
-  | "previewPackUninstall"
-  | "uninstallPack"
-  | "deletePack"
   // Workspaces + billing
   | "listWorkspaces"
   | "createWorkspace"
@@ -124,7 +101,6 @@ export type SessionClientLike = Pick<
   | "getAuthRun"
   | "startBrowserAuthRun"
   | "reportBrowserAuthRun"
-  | "protectedBrowserAuthFill"
   | "verifyBrowserAuthRun"
   | "listInteractionInterventions"
   | "getInteractionIntervention"
@@ -196,14 +172,20 @@ export type SessionClientLike = Pick<
       | "streamWorkspaceLiveEvents"
       | "listSessionBackgroundCommands"
       | "cancelSessionBackgroundCommand"
+      | "getComputerInputPosture"
+      | "getSessionModelAccount"
     >
   >;
 
+/** Compact list transport is optional for scripted and older clients. */
+export type SessionClientLike = SessionClientMethods &
+  Partial<Pick<OpenGeniClient, "listSessionSummaryPage" | "findGoal">>;
+
 /**
  * Tenant-safe client surface required by the session-only React entry.
  *
  * A host proxy can implement only these session-scoped operations instead of
- * stubbing OpenGeni's workbench, billing, rig, file-system, and workspace
+ * stubbing Opengeni's workbench, billing, rig, file-system, and workspace
  * administration APIs. Workspace-level resume is deliberately optional: a
  * host that does not expose that authority still supports every session-local
  * composer/control path.
@@ -237,16 +219,23 @@ export type EmbeddedSessionEventClientLike = Pick<OpenGeniClient, "getSession" |
 export type EmbeddedSessionReadClientLike = EmbeddedSessionEventClientLike &
   Pick<OpenGeniClient, "getSession" | "updateSession">;
 
-/** Exact client surface required by {@link useGoal}. */
+/**
+ * Exact client surface required by {@link useGoal}. `findGoal` is optional:
+ * when present the hook reads a goal-less session as a successful `null`
+ * instead of an absorbed 404.
+ */
 export type EmbeddedGoalClientLike = EmbeddedSessionEventClientLike &
-  Pick<OpenGeniClient, "getGoal" | "updateGoal" | "deleteGoal">;
+  Pick<OpenGeniClient, "getGoal" | "updateGoal" | "deleteGoal"> & {
+    findGoal?: OpenGeniClient["findGoal"] | undefined;
+  };
 
 /** Exact client surface required by {@link useSessionLineage}. */
 export type EmbeddedSessionLineageClientLike = EmbeddedSessionEventClientLike &
   Pick<OpenGeniClient, "getSessionLineage">;
 
 /** Exact client surface required by {@link useFileAttachments}. */
-export type EmbeddedFileAttachmentClientLike = Pick<OpenGeniClient, "uploadFile">;
+export type EmbeddedFileAttachmentClientLike = Pick<OpenGeniClient, "uploadFile"> &
+  Partial<Pick<OpenGeniClient, "createFileDownloadUrl">>;
 
 /** Exact client surface required by structured human-input hooks. */
 export type EmbeddedHumanInputSessionClientLike = EmbeddedSessionEventClientLike &
@@ -296,7 +285,6 @@ export type EmbeddedBrowserInteractionClientLike = Pick<
   | "getAuthRun"
   | "startBrowserAuthRun"
   | "reportBrowserAuthRun"
-  | "protectedBrowserAuthFill"
   | "verifyBrowserAuthRun"
   | "listInteractionInterventions"
   | "getInteractionIntervention"
@@ -349,7 +337,8 @@ export type EmbeddedComputerInteractionClientLike = Pick<
   | "heartbeatComputerSession"
   | "endComputerSession"
 > &
-  EmbeddedInterventionClientLike;
+  EmbeddedInterventionClientLike &
+  Partial<Pick<OpenGeniClient, "getComputerInputPosture">>;
 
 /** Complete public Browser + Computer interaction surface. */
 export type EmbeddedInteractionClientLike = EmbeddedBrowserInteractionClientLike &

package/src/commands/registry.ts

@@ -1,4 +1,5 @@
 import type { Permission } from "@opengeni/sdk";
+import { formatErrorMessage } from "@opengeni/sdk";
 import type { CommandContext, SlashArg, SlashCommand } from "./types";
 
 /**
@@ -182,7 +183,10 @@ export const defaultCommands: readonly SlashCommand[] = [
         });
         return { status: "ok", message: action === "pause" ? "Goal paused." : "Goal resumed." };
       } catch (cause) {
-        return { status: "error", message: goalErrorMessage(cause, action) };
+        return {
+          status: "error",
+          message: commandErrorMessage(ctx, cause, goalErrorMessage(cause, action)),
+        };
       }
     },
   },
@@ -197,7 +201,7 @@ export const defaultCommands: readonly SlashCommand[] = [
         const result = await ctx.client.compactSessionContext(ctx.workspaceId, sessionId);
         return { status: "ok", message: result.message };
       } catch (cause) {
-        return { status: "error", message: errorMessage(cause) ?? "Could not compact context." };
+        return { status: "error", message: commandErrorMessage(ctx, cause) };
       }
     },
   },
@@ -219,22 +223,21 @@ export const defaultCommands: readonly SlashCommand[] = [
         await ctx.client.clearSessionContext(ctx.workspaceId, sessionId);
         return { status: "ok", message: "Context cleared." };
       } catch (cause) {
-        return { status: "error", message: clearErrorMessage(cause) };
+        return {
+          status: "error",
+          message: commandErrorMessage(ctx, cause, clearErrorMessage(cause)),
+        };
       }
     },
   },
 ];
 
-function errorMessage(cause: unknown): string | undefined {
-  if (
-    cause &&
-    typeof cause === "object" &&
-    "message" in cause &&
-    typeof (cause as { message?: unknown }).message === "string"
-  ) {
-    return (cause as { message: string }).message;
-  }
-  return undefined;
+function commandErrorMessage(
+  ctx: CommandContext,
+  cause: unknown,
+  message = formatErrorMessage(cause),
+): string {
+  return ctx.formatError?.(cause, message) || message;
 }
 
 function statusCode(cause: unknown): number | undefined {
@@ -259,12 +262,12 @@ function goalErrorMessage(cause: unknown, action: "pause" | "resume"): string {
       ? "Only a paused goal can be resumed."
       : "Goal is already in a terminal state.";
   }
-  return errorMessage(cause) ?? `Could not ${action} the goal.`;
+  return formatErrorMessage(cause);
 }
 
 function clearErrorMessage(cause: unknown): string {
   if (statusCode(cause) === 409) {
     return "Pause the session and wait for the current inference to settle, then clear context.";
   }
-  return errorMessage(cause) ?? "Could not clear context.";
+  return formatErrorMessage(cause);
 }

package/src/commands/types.ts

@@ -41,6 +41,8 @@ export type CommandContext = {
   permissions: Permission[];
   /** Surface a transient ok/error notice in the composer. */
   notice: (notice: Notice) => void;
+  /** Optional presentation hook for native command failures; never rewrites command content. */
+  formatError?: ((error: unknown, defaultMessage: string) => string) | undefined;
   /** Open the in-composer /help panel (rendered from the registry). */
   openHelp: () => void;
   /**

package/src/components/anthropic-mark.tsx

@@ -0,0 +1,10 @@
+import type { SVGProps } from "react";
+
+/** AnthropicMark: Simple Icons, CC0; https://github.com/simple-icons/simple-icons */
+export function AnthropicMark(props: SVGProps<SVGSVGElement>) {
+  return (
+    <svg viewBox="0 0 24 24" fill="currentColor" aria-hidden="true" {...props}>
+      <path d="M17.3041 3.541h-3.6718l6.696 16.918H24Zm-10.6082 0L0 20.459h3.7442l1.3693-3.5527h7.0052l1.3693 3.5528h3.7442L10.5363 3.5409Zm-.3712 10.2232 2.2914-5.9456 2.2914 5.9456Z" />
+    </svg>
+  );
+}