@opengeni/react 0.1.0 → 0.3.0

package/dist/index.d.ts

@@ -1,5 +1,6 @@
-import { OpenGeniClient, Session, ResourceRef, ToolRef, SessionStatus as SessionStatus$1, SessionEvent, StreamConnectionState, SendMessageInput, FileAsset, FileResourceRef, SessionTurn, UpdateSessionTurnRequest, SessionGoal, ScheduledTask, WorkspaceEnvironment, CreateWorkspaceEnvironmentRequest, UpdateWorkspaceEnvironmentRequest, WorkspaceEnvironmentVariableMetadata, CapabilityPack, PackInstallation, RegisterCapabilityPackRequest, WorkspaceRegisteredPack, EnablePackRequest, Workspace, CreateWorkspaceRequest, UpdateWorkspaceRequest, BillingBalance, UsageEvent, Permission } from '@opengeni/sdk';
+import { OpenGeniClient, Session, ResourceRef, ToolRef, SessionStatus as SessionStatus$1, SessionEvent, StreamConnectionState, SendMessageInput, FileAsset, FileResourceRef, SessionTurn, UpdateSessionTurnRequest, SessionGoal, ScheduledTask, WorkspaceEnvironment, CreateWorkspaceEnvironmentRequest, UpdateWorkspaceEnvironmentRequest, WorkspaceEnvironmentVariableMetadata, CapabilityPack, PackInstallation, RegisterCapabilityPackRequest, WorkspaceRegisteredPack, EnablePackRequest, Workspace, CreateWorkspaceRequest, UpdateWorkspaceRequest, BillingBalance, UsageEvent, ClientModel, Permission } from '@opengeni/sdk';
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
 import { ReactNode, KeyboardEvent, ClipboardEvent } from 'react';
 import { ClassValue } from 'clsx';
 
@@ -8,7 +9,7 @@ import { ClassValue } from 'clsx';
  * pass the real SDK client, a proxy-backed client that routes through their
  * own API, or a scripted client in tests/demos.
  */
-type SessionClientLike = Pick<OpenGeniClient, "getSession" | "listSessions" | "sendMessage" | "steerMessage" | "interrupt" | "sendApprovalDecision" | "streamEvents" | "listTurns" | "updateQueuedTurn" | "reorderQueuedTurns" | "deleteQueuedTurn" | "getGoal" | "updateGoal" | "clearSessionContext" | "compactSessionContext" | "listScheduledTasks" | "uploadFile" | "getFile" | "createFileDownloadUrl" | "listEnvironments" | "createEnvironment" | "updateEnvironment" | "deleteEnvironment" | "setEnvironmentVariable" | "deleteEnvironmentVariable" | "listPacks" | "registerPack" | "enablePack" | "deletePack" | "listWorkspaces" | "createWorkspace" | "updateWorkspace" | "getBillingUsage">;
+type SessionClientLike = Pick<OpenGeniClient, "getClientConfig" | "getSession" | "listSessions" | "sendMessage" | "steerMessage" | "interrupt" | "sendApprovalDecision" | "streamEvents" | "listTurns" | "updateQueuedTurn" | "reorderQueuedTurns" | "deleteQueuedTurn" | "getGoal" | "updateGoal" | "clearSessionContext" | "compactSessionContext" | "listScheduledTasks" | "uploadFile" | "getFile" | "createFileDownloadUrl" | "listEnvironments" | "createEnvironment" | "updateEnvironment" | "deleteEnvironment" | "setEnvironmentVariable" | "deleteEnvironmentVariable" | "listPacks" | "registerPack" | "enablePack" | "deletePack" | "listWorkspaces" | "createWorkspace" | "updateWorkspace" | "getBillingUsage">;
 
 type OpenGeniContextValue = {
     client: SessionClientLike;
@@ -538,6 +539,28 @@ type UseBillingUsageResult = {
  */
 declare function useBillingUsage(options?: UseBillingUsageOptions): UseBillingUsageResult;
 
+type UseAvailableModelsOptions = Pick<ClientOverride, "client"> & {
+    /** Refresh interval (ms). Off by default — the host model list rarely moves. */
+    pollIntervalMs?: number | undefined;
+    enabled?: boolean | undefined;
+};
+type UseAvailableModelsResult = {
+    /** The provider-grouped models the host exposes (empty until loaded). */
+    models: ClientModel[];
+    /** The deployment's default model id, null until loaded. */
+    defaultModel: string | null;
+    loading: boolean;
+    error: Error | null;
+    refresh: () => Promise<void>;
+};
+/**
+ * The host-exposed model list for a <ModelPicker>: fetches the deployment's
+ * public client config (`GET /v1/config/client`) and surfaces the richer
+ * provider-grouped `models` plus the `defaultModel` the picker should preselect.
+ * Deployment-scoped, so it only needs the client (no workspace).
+ */
+declare function useAvailableModels(options?: UseAvailableModelsOptions): UseAvailableModelsResult;
+
 type PendingApproval = {
     /** The id to send back via `user.approvalDecision` (`approvalId`). */
     id: string;
@@ -785,6 +808,20 @@ type ChatComposerProps = {
      * Absent → no attachment UI renders and the composer behaves exactly as before.
      */
     attachments?: UseFileAttachmentsResult | undefined;
+    /**
+     * Opt-in model picker. When supplied (e.g. from {@link useAvailableModels}),
+     * the composer renders a {@link ModelPicker} at the start of `controlsStart`
+     * so the operator can choose which host-exposed model serves the next message.
+     * The host owns the selection (`selectedModel`/`onSelectModel`) and is
+     * responsible for threading it into the composer's `sendExtras` (typically
+     * `useComposer({ sendExtras: () => ({ model }) })`) so `composeSendInput`
+     * carries it. Absent → no picker renders and the composer behaves as before.
+     */
+    models?: ClientModel[] | undefined;
+    /** The currently selected model id (the picker's controlled value). */
+    selectedModel?: string | undefined;
+    /** Called with the chosen model id when the operator picks one. */
+    onSelectModel?: ((modelId: string) => void) | undefined;
     className?: string | undefined;
     /**
      * Slash-command palette. Defaults to the built-in {@link defaultCommands};
@@ -811,7 +848,30 @@ type ChatComposerProps = {
  * the agent. The palette is purely additive: with no `commandContext` it is
  * inert and the composer behaves exactly as before.
  */
-declare function ChatComposer({ composer, status, placeholder, disabled, autoFocus, hint, controlsStart, header, onPaste, attachments, className, commands, commandContext, onClearView, }: ChatComposerProps): react_jsx_runtime.JSX.Element;
+declare function ChatComposer({ composer, status, placeholder, disabled, autoFocus, hint, controlsStart, header, onPaste, attachments, models, selectedModel, onSelectModel, className, commands, commandContext, onClearView, }: ChatComposerProps): react_jsx_runtime.JSX.Element;
+
+type ModelPickerProps = {
+    /** The host-exposed models to choose from (typically {@link useAvailableModels}). */
+    models: ClientModel[];
+    /** Controlled selection — the model id, or undefined for "nothing chosen yet". */
+    value?: string | undefined;
+    /** Called with the chosen model id when the operator picks a row. */
+    onChange: (modelId: string) => void;
+    disabled?: boolean | undefined;
+    className?: string | undefined;
+};
+/**
+ * The model picker — a compact dropdown for the composer footer, grouping the
+ * host-exposed models by `providerLabel` (so "OpenAI" and "Fireworks AI" head
+ * their own sections) and showing each model's display `label`. A native
+ * `<select>` keeps it keyboard- and screen-reader-accessible for free and
+ * themes via the package's og-* tokens; the chevron is a decorative overlay.
+ *
+ * Controlled: the host owns `value`/`onChange` and threads the selection into
+ * the send path. Renders nothing when no models are exposed, so a single-model
+ * deployment shows no chrome.
+ */
+declare function ModelPicker({ models, value, onChange, disabled, className }: ModelPickerProps): react_jsx_runtime.JSX.Element | null;
 
 type MessageTimelineProps = {
     /** Raw session events (projected internally) … */
@@ -837,6 +897,28 @@ type MessageTimelineProps = {
  */
 declare function MessageTimeline({ events, items, status, renderMessageText, onOpenSession, autoFollow, emptyState, className, }: MessageTimelineProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * The default renderer for chat message bodies in {@link MessageTimeline}.
+ *
+ * Agent (and user) messages arrive as GitHub-flavored markdown. This turns the
+ * raw text into styled HTML using `react-markdown` + `remark-gfm`, themed to the
+ * package's `og-*` design tokens so it reads as one cohesive dark surface — no
+ * stock Tailwind colors leak in.
+ *
+ * It re-parses on every render, which is exactly right for streaming: a body
+ * that is still arriving (an unterminated `**`, a half-open code fence, a table
+ * mid-row) renders as best-effort markdown and resolves cleanly as the rest of
+ * the tokens land. Consumers who want a different renderer can still pass
+ * `renderMessageText` to `MessageTimeline` to override this entirely.
+ */
+type MarkdownProps = {
+    children: string;
+    className?: string | undefined;
+};
+declare function MarkdownImpl({ children, className }: MarkdownProps): react_jsx_runtime.JSX.Element;
+/** Memoized so streaming re-renders of the parent don't re-parse settled bodies. */
+declare const Markdown: react.MemoExoticComponent<typeof MarkdownImpl>;
+
 type SessionStatusMeta = {
     label: string;
     /** Token-backed color classes for the dot and tinted badge. */
@@ -894,4 +976,4 @@ declare function stringifyPayload(value: unknown): string;
 /** JSON.parse that returns `undefined` instead of throwing. */
 declare function tryParseJson(text: string): unknown;
 
-export { type AgentMessageItem, ChatComposer, type ChatComposerProps, type ClientOverride, type CommandContext, CommandPalette, type CommandPaletteProps, type CommandResult, type ComposerMode, type ComposerSendExtras, type ComposerState, type ConfirmState, type FileAttachment, FleetTile, type FleetTileProps, type GoalItem, MessageTimeline, type MessageTimelineProps, type Notice, type NoticeItem, type OpenGeniContextValue, OpenGeniProvider, type OpenGeniProviderProps, type ParsedCommandLine, type PendingApproval, type ReasoningItem, SESSION_STATUS_META, type SandboxItem, type SessionClientLike, type SessionEventsConnectionState, SessionStatus, type SessionStatusItem, type SessionStatusMeta, type SessionStatusProps, type SlashArg, type SlashCommand, type SlashCommandContext, type SlashCommandHandlers, StatusDot, type StatusDotProps, type TimelineGroup, type TimelineItem, type ToolCallItem, type UseBillingUsageOptions, type UseBillingUsageResult, type UseComposerOptions, type UseEnvironmentsOptions, type UseEnvironmentsResult, type UseFileAttachmentsOptions, type UseFileAttachmentsResult, type UseGoalOptions, type UseGoalResult, type UsePacksOptions, type UsePacksResult, type UseScheduledTasksOptions, type UseScheduledTasksResult, type UseSessionControlOptions, type UseSessionControlResult, type UseSessionEventsOptions, type UseSessionEventsResult, type UseSessionOptions, type UseSessionResult, type UseSlashCommandsOptions, type UseSlashCommandsResult, type UseTurnQueueOptions, type UseTurnQueueResult, type UseWorkspaceSessionsOptions, type UseWorkspaceSessionsResult, type UseWorkspacesOptions, type UseWorkspacesResult, type UserMessageItem, type WorkerItem, activeTurnFromTurns, applyTurnEdit, applyTurnRemoval, applyTurnReorder, approvalsFromRequiresAction, argHint, buildTimeline, cn, compactPayloadPreview, composeSendInput, defaultCommands, extractSessionRef, filterCommands, firstMissingRequiredArg, formatBytes, formatRelativeTime, groupTimeline, hasPermission, isGoalEvent, isTurnQueueEvent, matchCommand, parseCommandLine, projectPendingApprovals, queueFromTurns, sessionDisplayTitle, sessionStatusFromEvents, shouldSubmitOnKey, stringifyPayload, toolDisplayName, truncate, tryParseJson, useBillingUsage, useComposer, useEnvironments, useFileAttachments, useGoal, useOpenGeni, useOpenGeniClient, usePacks, useScheduledTasks, useSession, useSessionControl, useSessionEvents, useSlashCommands, useTurnQueue, useWorkspaceSessions, useWorkspaces };
+export { type AgentMessageItem, ChatComposer, type ChatComposerProps, type ClientOverride, type CommandContext, CommandPalette, type CommandPaletteProps, type CommandResult, type ComposerMode, type ComposerSendExtras, type ComposerState, type ConfirmState, type FileAttachment, FleetTile, type FleetTileProps, type GoalItem, Markdown, type MarkdownProps, MessageTimeline, type MessageTimelineProps, ModelPicker, type ModelPickerProps, type Notice, type NoticeItem, type OpenGeniContextValue, OpenGeniProvider, type OpenGeniProviderProps, type ParsedCommandLine, type PendingApproval, type ReasoningItem, SESSION_STATUS_META, type SandboxItem, type SessionClientLike, type SessionEventsConnectionState, SessionStatus, type SessionStatusItem, type SessionStatusMeta, type SessionStatusProps, type SlashArg, type SlashCommand, type SlashCommandContext, type SlashCommandHandlers, StatusDot, type StatusDotProps, type TimelineGroup, type TimelineItem, type ToolCallItem, type UseAvailableModelsOptions, type UseAvailableModelsResult, type UseBillingUsageOptions, type UseBillingUsageResult, type UseComposerOptions, type UseEnvironmentsOptions, type UseEnvironmentsResult, type UseFileAttachmentsOptions, type UseFileAttachmentsResult, type UseGoalOptions, type UseGoalResult, type UsePacksOptions, type UsePacksResult, type UseScheduledTasksOptions, type UseScheduledTasksResult, type UseSessionControlOptions, type UseSessionControlResult, type UseSessionEventsOptions, type UseSessionEventsResult, type UseSessionOptions, type UseSessionResult, type UseSlashCommandsOptions, type UseSlashCommandsResult, type UseTurnQueueOptions, type UseTurnQueueResult, type UseWorkspaceSessionsOptions, type UseWorkspaceSessionsResult, type UseWorkspacesOptions, type UseWorkspacesResult, type UserMessageItem, type WorkerItem, activeTurnFromTurns, applyTurnEdit, applyTurnRemoval, applyTurnReorder, approvalsFromRequiresAction, argHint, buildTimeline, cn, compactPayloadPreview, composeSendInput, defaultCommands, extractSessionRef, filterCommands, firstMissingRequiredArg, formatBytes, formatRelativeTime, groupTimeline, hasPermission, isGoalEvent, isTurnQueueEvent, matchCommand, parseCommandLine, projectPendingApprovals, queueFromTurns, sessionDisplayTitle, sessionStatusFromEvents, shouldSubmitOnKey, stringifyPayload, toolDisplayName, truncate, tryParseJson, useAvailableModels, useBillingUsage, useComposer, useEnvironments, useFileAttachments, useGoal, useOpenGeni, useOpenGeniClient, usePacks, useScheduledTasks, useSession, useSessionControl, useSessionEvents, useSlashCommands, useTurnQueue, useWorkspaceSessions, useWorkspaces };