@opengeni/react 3.3.2 → 3.4.0

package/dist/plugin-discovery.d.ts

@@ -0,0 +1,25 @@
+import { type ReactNode } from "react";
+import type { PluginDiscoveryItem, PluginDiscoveryPage } from "@opengeni/sdk";
+export type PluginDiscoveryProps = {
+    client: {
+        discoverPlugins(workspaceId: string, options?: {
+            query?: string;
+            provider?: string;
+            offset?: number;
+        }): Promise<PluginDiscoveryPage>;
+    };
+    workspaceId: string;
+    query: string;
+    /** Initially selected registry. Users can still switch registries or browse all. */
+    defaultProvider?: "" | "openai" | "anthropic";
+    /** Discovery identities already installed in the current workspace. */
+    installedIds?: ReadonlySet<string>;
+    resultLimit?: number;
+    onShowMore?: () => void;
+    onOpen: (item: PluginDiscoveryItem) => void;
+    /** Display name for a registry slug. Defaults to the slug with dashes as spaces. */
+    formatName?: (name: string) => string;
+    /** The row tile. Defaults to the plugin logo with a glyph fallback. */
+    renderIcon?: (item: PluginDiscoveryItem) => ReactNode;
+};
+export declare function PluginDiscovery(props: PluginDiscoveryProps): import("react").JSX.Element;

package/dist/preview-loading-paint.d.ts

@@ -0,0 +1,20 @@
+/**
+ * One frame of the "Preparing preview…" ripple: a soft drifting glow under an
+ * 18px lattice whose points swell along an outward wave. DOM-free and
+ * self-contained (it closes over nothing), so the web canvas effect and the
+ * native preview document (which embeds its source) draw the same thing.
+ */
+export declare function paintPreviewLoading(context: CanvasRenderingContext2D, width: number, height: number, time: number, ink: string, glowColor: string): void;
+/** The ripple's private ink and glow, tuned to the app's teal on a neutral ground. */
+export declare const PREVIEW_LOADING_COLORS: {
+    readonly dark: {
+        readonly ink: "#9fdccd";
+        readonly glow: "#5fb8a3";
+        readonly background: "#1b1b1b";
+    };
+    readonly light: {
+        readonly ink: "#5f8f84";
+        readonly glow: "#9fe3d3";
+        readonly background: "#f9f9f9";
+    };
+};

package/dist/provider.d.ts

@@ -1,6 +1,8 @@
 import { type WorkspaceControlEvent, type WorkspaceInteractionRevisionEvent } from "@opengeni/sdk";
 import { type ReactNode } from "react";
 import type { SessionClientLike } from "./client.js";
+import { type ErrorMessageFormatter } from "./lib/error-message.js";
+export type { ErrorMessageFormatter } from "./lib/error-message.js";
 export { useOpenGeni, useOpenGeniClient } from "./session-context.js";
 export type { ClientOverride, OpenGeniContextValue } from "./session-context.js";
 export type OpenGeniProviderProps = {
@@ -8,10 +10,31 @@ export type OpenGeniProviderProps = {
     workspaceId: string;
     onWorkspaceControlEvent?: ((event: WorkspaceControlEvent) => void) | undefined;
     onWorkspaceInteractionEvent?: ((event: WorkspaceInteractionRevisionEvent) => void) | undefined;
+    /**
+     * Stale-tab protection for the stock Opengeni web app: when the server's API
+     * contract revision differs from this bundle's, cover the page and reload it
+     * once. Off by default, because an embedded product's page must never be
+     * blocked or reloaded when Opengeni deploys; there a mismatch is ignored and
+     * the SDK's tolerant-reader compatibility applies.
+     */
+    reloadOnApiContractChange?: boolean | undefined;
+    /**
+     * Keep subscription account lists and usage readings (`useCodexAccounts`,
+     * `useSuperGrokAccounts`) for `client` after the components that read them
+     * unmount, so returning to them renders the last rows at once and re-reads
+     * in the background. Off by default: then readers mounted together share one
+     * request, but nothing is served to a later mount. Opt in only when every
+     * signed-in person gets their own `client` object (the stock Opengeni console
+     * creates a new client on every identity change). Retained rows are dropped
+     * when `client` changes or this provider unmounts.
+     */
+    retainReadsAcrossMounts?: boolean | undefined;
+    /** Host-owned error copy. Receives the original diagnostic error and neutral default copy. */
+    formatError?: ErrorMessageFormatter | undefined;
     children?: ReactNode;
 };
 /**
- * Supplies the OpenGeni client + workspace to all hooks below it. Hooks also
+ * Supplies the Opengeni client + workspace to all hooks below it. Hooks also
  * accept `{ client, workspaceId }` overrides per call for multi-workspace UIs.
  */
-export declare function OpenGeniProvider({ client, workspaceId, onWorkspaceControlEvent, onWorkspaceInteractionEvent, children, }: OpenGeniProviderProps): import("react").JSX.Element;
+export declare function OpenGeniProvider({ client, workspaceId, onWorkspaceControlEvent, onWorkspaceInteractionEvent, reloadOnApiContractChange, retainReadsAcrossMounts, formatError, children, }: OpenGeniProviderProps): import("react").JSX.Element;

package/dist/queue-presentation-model.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Queue presentation shared by the web queue surface and native docks: the
+ * bounded head/tail previews of queued prompts, and the reorder plan and its
+ * optimistic projection. No DOM, no React.
+ */
+import type { SessionQueueSnapshot, SessionTurn } from "@opengeni/sdk";
+import { QUEUE_ITEM_CONTENT_UNAVAILABLE, queueItemContent } from "./components/queue-item-content.js";
+export { QUEUE_ITEM_CONTENT_UNAVAILABLE, queueItemContent };
+export declare const QUEUE_ROW_PREVIEW_CHARACTERS = 360;
+export declare const QUEUE_COLLAPSED_PREVIEW_CHARACTERS = 180;
+export type QueuePromptPreview = {
+    summary: string;
+    collapsedVisual: string;
+    visibleStart: string;
+    visibleIdentity: string | null;
+    visibleIdentityLabel: "End" | "Safe boundary" | null;
+    isFallback: boolean;
+};
+export declare function queueTurnPreview(turn: SessionTurn | undefined, maxCharacters: number): QueuePromptPreview;
+export declare function queueContentPreview(prompt: string, annotationCount: number, maxCharacters: number): QueuePromptPreview;
+/**
+ * Build a bounded head/tail summary of an arbitrary queued prompt. Sampling
+ * both ends distinguishes prompts with equal long prefixes. Each sampled edge
+ * has a small amount of grapheme context so ordinary emoji/combining sequences
+ * can be retained whole. A cluster that exceeds that context is omitted rather
+ * than fragmented, and malformed UTF-16 is replaced only in the summary. The
+ * durable prompt remains exact and no operation scans or copies it in full.
+ */
+export declare function queuePromptPreview(prompt: string, maxCharacters: number): QueuePromptPreview;
+/** Move one item, as dnd-kit's arrayMove does. */
+export declare function moveQueueItem<T>(items: readonly T[], from: number, to: number): T[];
+export type QueueMovePlan = {
+    /** The turn ids in their new order. */
+    turnIds: string[];
+    /** The server anchor: the turn the moved one now precedes, null for last. */
+    beforeTurnId: string | null;
+    /** The bounded destination index. */
+    index: number;
+};
+/** The reorder request for moving a queued turn to an index, or null for a no-op. */
+export declare function queueMovePlan(queue: readonly SessionTurn[], turnId: string, nextIndex: number): QueueMovePlan | null;
+export type PendingQueueMove = {
+    baseVersion: number | null;
+    turnIds: string[];
+};
+/**
+ * The queue as shown while a move is in flight: the optimistic order, unless
+ * any authoritative change arrived. A projection never omits or invents a row.
+ */
+export declare function projectPendingQueueMove(queue: SessionTurn[], pendingMove: PendingQueueMove | null, snapshot: Pick<SessionQueueSnapshot, "version"> | null): SessionTurn[];
+/** Copy for the "replace your draft with this queued prompt" confirmation. */
+export declare const QUEUE_REPLACE_DRAFT_COPY: {
+    readonly title: "Your composer already has a draft. Replace it with this queued prompt?";
+    readonly detail: "The current draft will be permanently discarded; this queued prompt is preserved until you confirm.";
+    readonly keep: "Keep current draft";
+    readonly replace: "Replace and edit";
+};
+export type QueuedTurnPresentation = {
+    kind: "prompt" | "realtime_voice" | "realtime_voice_handoff";
+    text: string;
+};
+/** What a queued row shows: the prompt, or the transcript of a voice request. */
+export declare function queuedTurnPresentation(turn: SessionTurn): QueuedTurnPresentation;
+export declare function isSteeringTurn(turn: SessionTurn): boolean;
+/** A queued turn that is really waiting: not already a steer in flight. */
+export declare function isAuthoritativeQueuedTurn(turn: SessionTurn, mutationFor: (turnId: string) => string | null): boolean;
+export declare function countAuthoritativeQueuedTurns(turns: readonly SessionTurn[], mutationFor: (turnId: string) => string | null): number;
+/** The move anchors for one row's Move up / Move down. */
+export declare function queueNeighborAnchors(turns: readonly SessionTurn[], index: number): {
+    beforeUp: string | null;
+    beforeDown: string | null;
+};

package/dist/queue-presentation-model.js

@@ -0,0 +1,38 @@
+"use client";
+import {
+  QUEUE_COLLAPSED_PREVIEW_CHARACTERS,
+  QUEUE_ITEM_CONTENT_UNAVAILABLE,
+  QUEUE_REPLACE_DRAFT_COPY,
+  QUEUE_ROW_PREVIEW_CHARACTERS,
+  countAuthoritativeQueuedTurns,
+  isAuthoritativeQueuedTurn,
+  isSteeringTurn,
+  moveQueueItem,
+  projectPendingQueueMove,
+  queueContentPreview,
+  queueItemContent,
+  queueMovePlan,
+  queueNeighborAnchors,
+  queuePromptPreview,
+  queueTurnPreview,
+  queuedTurnPresentation
+} from "./chunk-RI42H5IU.js";
+export {
+  QUEUE_COLLAPSED_PREVIEW_CHARACTERS,
+  QUEUE_ITEM_CONTENT_UNAVAILABLE,
+  QUEUE_REPLACE_DRAFT_COPY,
+  QUEUE_ROW_PREVIEW_CHARACTERS,
+  countAuthoritativeQueuedTurns,
+  isAuthoritativeQueuedTurn,
+  isSteeringTurn,
+  moveQueueItem,
+  projectPendingQueueMove,
+  queueContentPreview,
+  queueItemContent,
+  queueMovePlan,
+  queueNeighborAnchors,
+  queuePromptPreview,
+  queueTurnPreview,
+  queuedTurnPresentation
+};
+//# sourceMappingURL=queue-presentation-model.js.map

package/dist/queue-presentation-model.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}