@mcpstack/agent-sdk 1.0.0-pr.16.7572c080abaa.13.1

package/dist/react-embed/index.d.mts

@@ -0,0 +1,361 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import React from 'react';
+
+interface ClientToolParameter {
+    type: string;
+    description?: string;
+    required?: boolean;
+    enum?: string[];
+    items?: ClientToolParameter;
+    properties?: Record<string, ClientToolParameter>;
+    additionalProperties?: boolean | ClientToolParameter;
+}
+interface ClientToolDefinition {
+    description: string;
+    parameters: Record<string, ClientToolParameter>;
+    selection?: ClientToolSelection;
+    execute: (params: Record<string, unknown>) => Promise<unknown>;
+}
+type ClientToolsMap$1 = Record<string, ClientToolDefinition>;
+interface ClientToolSelection {
+    categories?: string[];
+    alwaysInclude?: boolean;
+    includeWhen?: string[];
+    risk?: 'low' | 'medium' | 'high' | string;
+    serverPreferred?: boolean;
+}
+interface McpStackEmbeddedAuthIdentity {
+    subject?: string;
+    email?: string;
+    organizationId?: string;
+    displayName?: string;
+    avatarUrl?: string;
+}
+interface McpStackAppTokenAuthConfig {
+    mode: 'app-token';
+    appId?: string;
+    getToken: () => Promise<string | undefined> | string | undefined;
+}
+interface McpStackStorageLike {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+}
+interface ChatMessage {
+    id: string;
+    role: 'user' | 'assistant' | 'tool_call' | 'tool_result' | 'error';
+    content: string;
+    toolName?: string;
+    toolLabel?: string;
+    toolCallId?: string;
+    timestamp: Date;
+    toolCallStatus?: 'calling' | 'completed' | 'error';
+    toolCallStartTime?: number;
+    toolCallDuration?: number;
+    toolResult?: string;
+    toolError?: string;
+    errorCode?: string;
+    metadataJson?: string | null;
+}
+interface McpServerAuthConfig {
+    authType: 'none' | 'apiKey' | 'bearer' | 'oauth2';
+    issuer?: string;
+    authorizationServerUrl?: string;
+    authorizationServerMetadataUrl?: string;
+    authorizationEndpoint?: string;
+    loginUrl?: string;
+    tokenEndpoint?: string;
+    tokenUrl?: string;
+    registrationEndpoint?: string;
+    clientId?: string;
+    scopes?: string[];
+    resource?: string;
+    callbackUrl?: string;
+    protectedResourceMetadataUrl?: string;
+    clientIdMetadataDocumentSupported?: boolean;
+    resourceParameterSupported?: boolean;
+    registrationPreference?: McpClientRegistrationPreference;
+    clientMode?: McpResolvedClientMode;
+    authRecipe?: McpAuthRecipe;
+    manualOverrides?: string[];
+    discovered?: boolean;
+}
+type McpAuthRecipe = 'sqlos' | 'auth0' | 'entra' | 'workos' | 'manual';
+type McpClientRegistrationPreference = 'auto' | 'preregistered' | 'cimd' | 'dcr' | 'manual';
+type McpResolvedClientMode = 'preregistered' | 'cimd' | 'dcr' | 'manual';
+/** OAuth token response from token endpoint */
+interface OAuthTokenResponse {
+    accessToken: string;
+    refreshToken?: string;
+    expiresIn?: number;
+    tokenType?: string;
+    resolvedAuthConfig?: McpServerAuthConfig;
+}
+interface AgentBudgetSnapshot {
+    enabled: boolean;
+    currency: string;
+    identityType: 'identified' | 'anonymous' | string;
+    externalUserId: string;
+    displayName: string;
+    budgetSource: 'explicit' | 'default_user' | 'anonymous' | 'none' | string;
+    windowStartUtc: string;
+    windowEndUtc: string;
+    agentMonthlyBudgetUsd?: number | null;
+    agentCurrentMonthSpendUsd: number;
+    agentRemainingBudgetUsd?: number | null;
+    userMonthlyBudgetUsd?: number | null;
+    userCurrentMonthSpendUsd: number;
+    userRemainingBudgetUsd?: number | null;
+    organizationCreditsRemainingUsd?: number | null;
+    effectiveRemainingUsd?: number | null;
+    status: 'healthy' | 'warning' | 'blocked' | 'disabled' | string;
+}
+interface SseError {
+    code: string;
+    message: string;
+    budget?: AgentBudgetSnapshot | null;
+}
+type AudioInputStatus = 'idle' | 'requesting_permission' | 'connecting' | 'listening' | 'transcribing' | 'sending' | 'error';
+interface AudioInputState {
+    status: AudioInputStatus;
+    isSupported: boolean;
+    isEnabled: boolean;
+    transcript: string;
+    partialTranscript: string;
+    error: SseError | null;
+    sessionId?: string | null;
+    conversationId?: string | null;
+    maxSessionSeconds?: number | null;
+    inputLevel?: number;
+    isSpeaking?: boolean;
+    speechMs?: number;
+    silenceMs?: number;
+    autoSubmitEnabled?: boolean;
+}
+
+type ClientToolsMap = ClientToolsMap$1;
+type AppAgentUserIdentity = McpStackEmbeddedAuthIdentity;
+interface KeyValueStore {
+    getItem(key: string): Promise<string | null> | string | null;
+    setItem(key: string, value: string): Promise<void> | void;
+    removeItem(key: string): Promise<void> | void;
+}
+interface OAuthSessionRequest {
+    authorizeUrl: string;
+    redirectUri: string;
+    preferEphemeralSession?: boolean;
+}
+type OAuthSessionResult = {
+    type: 'success';
+    url: string;
+} | {
+    type: 'cancel' | 'dismiss';
+} | {
+    type: 'error';
+    message?: string;
+};
+interface AppAgentPlatform {
+    storage?: {
+        durable: KeyValueStore;
+        secure?: KeyValueStore;
+    };
+    auth?: {
+        openOAuthSession(request: OAuthSessionRequest): Promise<OAuthSessionResult>;
+        dismissOAuthSession?(): Promise<void> | void;
+    };
+    lifecycle?: {
+        onForegroundChange?(listener: (isForeground: boolean) => void): () => void;
+        onConnectivityChange?(listener: (isOnline: boolean) => void): () => void;
+    };
+}
+interface AppAgentConnection {
+    url: string;
+    name: string;
+    authStatus: 'connected' | 'needs_auth';
+    canSignOut: boolean;
+}
+interface AppAgentConfig {
+    apiKey: string;
+    agentId: string;
+    serviceUrl?: string;
+    initialConnections?: AppAgentConnection[];
+    oauthCallbackUrl?: string;
+    oauthClientMetadataUrl?: string;
+    getAuthToken?: () => Promise<string | undefined>;
+    appSessionKey?: string | null;
+    userIdentity?: AppAgentUserIdentity;
+    auth?: McpStackAppTokenAuthConfig;
+    useCookies?: boolean;
+    externalUserId?: string;
+    appContext?: Record<string, unknown>;
+    clientTools?: ClientToolsMap;
+    platform?: AppAgentPlatform;
+    onAuthRequired?: (mcpServerUrl: string, authConfig: McpServerAuthConfig) => Promise<OAuthTokenResponse | undefined>;
+    conversation?: {
+        namespace?: string;
+        historyPageSize?: number;
+    };
+    feedbackSource?: string;
+    storage?: McpStackStorageLike | null;
+}
+
+interface McpStackChatProps extends AppAgentConfig {
+    /**
+     * Display mode:
+     * - 'floating': chat popup with a fixed button (default)
+     * - 'inline': embedded assistant that fills its container
+     */
+    mode?: 'floating' | 'inline';
+    /** Chat window title */
+    title?: string;
+    /** Welcome message shown when no messages exist */
+    welcomeMessage?: string;
+    /** Input placeholder text */
+    placeholder?: string;
+    /** Whether the widget starts open (floating mode only) */
+    defaultOpen?: boolean;
+    /** Called when a tool call completes or a turn settles after tool activity. */
+    onToolActivity?: () => void;
+}
+declare function McpStackChat({ mode, title, welcomeMessage, placeholder, defaultOpen, onToolActivity, ...agentConfig }: McpStackChatProps): react_jsx_runtime.JSX.Element;
+
+interface McpServerStatus {
+    url: string;
+    name: string;
+    authStatus: 'connected' | 'needs_auth';
+    canSignOut?: boolean;
+}
+interface McpServerStatusBarProps {
+    servers: McpServerStatus[];
+    onAuthClick?: (serverUrl: string, serverName: string) => void;
+    onSignOutClick?: (serverUrl: string, serverName: string) => void;
+    authButtonLabel?: string;
+}
+declare function McpServerStatusBar({ servers, onAuthClick, onSignOutClick, authButtonLabel, }: McpServerStatusBarProps): react_jsx_runtime.JSX.Element | null;
+
+interface ChatWindowProps {
+    messages: ChatMessage[];
+    streamingContent: string;
+    isLoading: boolean;
+    isLoadingHistory?: boolean;
+    isThinking?: boolean;
+    error: SseError | null;
+    budget?: AgentBudgetSnapshot | null;
+    hasOlderMessages?: boolean;
+    title?: string;
+    welcomeMessage?: string;
+    placeholder?: string;
+    mcpServers?: McpServerStatus[];
+    mcpAuthButtonLabel?: string;
+    onSend: (message: string) => void;
+    onLoadOlderMessages?: () => void | Promise<void>;
+    onClose?: () => void;
+    onNewConversation?: () => void;
+    onMcpAuthClick?: (serverUrl: string, serverName: string) => void;
+    onMcpSignOutClick?: (serverUrl: string, serverName: string) => void;
+    voice?: AudioInputState & {
+        onStart: () => void;
+        onStop: () => void;
+        onCancel: () => void;
+    };
+    /** 'floating' = fixed card (default), 'inline' = fill container */
+    variant?: 'floating' | 'inline';
+}
+declare function ChatWindow({ messages, streamingContent, isLoading, isLoadingHistory, isThinking, error, budget, hasOlderMessages, title, welcomeMessage, placeholder, mcpServers, mcpAuthButtonLabel, onSend, onLoadOlderMessages, onClose, onNewConversation, onMcpAuthClick, onMcpSignOutClick, voice, variant, }: ChatWindowProps): react_jsx_runtime.JSX.Element;
+
+interface MessageListProps {
+    messages: ChatMessage[];
+    streamingContent: string;
+    welcomeMessage?: string;
+    isThinking?: boolean;
+    blockingError?: SseError | null;
+    hasOlderMessages?: boolean;
+    isLoadingHistory?: boolean;
+    onLoadOlderMessages?: () => void | Promise<void>;
+}
+declare function MessageList({ messages, streamingContent, welcomeMessage, isThinking, blockingError, hasOlderMessages, isLoadingHistory, onLoadOlderMessages, }: MessageListProps): react_jsx_runtime.JSX.Element;
+
+interface MessageBubbleProps {
+    message: ChatMessage;
+}
+declare function MessageBubble({ message }: MessageBubbleProps): react_jsx_runtime.JSX.Element | null;
+
+interface InputAreaProps {
+    onSend: (message: string) => void;
+    disabled?: boolean;
+    placeholder?: string;
+    voice?: AudioInputState & {
+        onStart: () => void;
+        onStop: () => void;
+        onCancel: () => void;
+    };
+}
+declare function InputArea({ onSend, disabled, placeholder, voice }: InputAreaProps): react_jsx_runtime.JSX.Element;
+
+interface WidgetButtonProps {
+    isOpen: boolean;
+    onClick: () => void;
+}
+/**
+ * Floating action button that toggles the chat window.
+ */
+declare function WidgetButton({ isOpen, onClick }: WidgetButtonProps): react_jsx_runtime.JSX.Element;
+
+type OAuthPopupPhase = 'prompt' | 'preparing' | 'waiting' | 'exchanging' | 'blocked' | 'canceled' | 'error';
+interface OAuthPopupViewState {
+    serverName: string;
+    serverUrl: string;
+    phase: OAuthPopupPhase;
+    statusMessage?: string | null;
+    errorMessage?: string | null;
+    hostIdentityLabel?: string | null;
+}
+interface OAuthPopupProps extends OAuthPopupViewState {
+    onPrimaryAction?: () => void;
+    onClose: () => void;
+}
+declare function OAuthPopup({ serverName, phase, statusMessage, errorMessage, hostIdentityLabel, onPrimaryAction, onClose, }: OAuthPopupProps): react_jsx_runtime.JSX.Element;
+
+interface EnhancedToolCallCardProps {
+    toolName: string;
+    toolCallId: string;
+    status: 'calling' | 'completed' | 'error';
+    startTime: number;
+    duration?: number;
+    result?: string;
+    error?: string;
+}
+declare function EnhancedToolCallCard({ toolName, toolCallId: _toolCallId, status, startTime, duration, result, error, }: EnhancedToolCallCardProps): react_jsx_runtime.JSX.Element;
+
+interface MarkdownRendererProps {
+    content: string;
+}
+declare function MarkdownRenderer({ content }: MarkdownRendererProps): react_jsx_runtime.JSX.Element;
+
+declare function ThinkingIndicator(): react_jsx_runtime.JSX.Element;
+
+declare function StreamingCursor(): react_jsx_runtime.JSX.Element;
+
+interface IconProps {
+    size?: number;
+    color?: string;
+    className?: string;
+}
+declare function DatabaseIcon({ size, color, className }: IconProps): react_jsx_runtime.JSX.Element;
+declare function EditIcon({ size, color, className }: IconProps): react_jsx_runtime.JSX.Element;
+declare function TrashIcon({ size, color, className }: IconProps): react_jsx_runtime.JSX.Element;
+declare function ToolWrenchIcon({ size, color, className }: IconProps): react_jsx_runtime.JSX.Element;
+declare function CheckCircleIcon({ size, color, className }: IconProps): react_jsx_runtime.JSX.Element;
+declare function XCircleIcon({ size, color, className }: IconProps): react_jsx_runtime.JSX.Element;
+declare function SpinnerIcon({ size, color, className }: IconProps): react_jsx_runtime.JSX.Element;
+declare function ChevronIcon({ size, color, className, direction }: IconProps & {
+    direction?: 'up' | 'down';
+}): react_jsx_runtime.JSX.Element;
+declare function SendIcon({ size, color, className }: IconProps): react_jsx_runtime.JSX.Element;
+declare function PlusIcon({ size, color, className }: IconProps): react_jsx_runtime.JSX.Element;
+declare function CloseIcon({ size, color, className }: IconProps): react_jsx_runtime.JSX.Element;
+declare function ChatBubbleIcon({ size, color, className }: IconProps): react_jsx_runtime.JSX.Element;
+/** Pattern-match tool name to an appropriate icon */
+declare function getToolIcon(toolName: string): React.FC<IconProps>;
+
+export { ChatBubbleIcon, ChatWindow, type ChatWindowProps, CheckCircleIcon, ChevronIcon, CloseIcon, DatabaseIcon, EditIcon, EnhancedToolCallCard, type EnhancedToolCallCardProps, InputArea, type InputAreaProps, MarkdownRenderer, type McpServerStatus, McpServerStatusBar, type McpServerStatusBarProps, McpStackChat, type McpStackChatProps, MessageBubble, type MessageBubbleProps, MessageList, type MessageListProps, OAuthPopup, type OAuthPopupProps, PlusIcon, SendIcon, SpinnerIcon, StreamingCursor, ThinkingIndicator, ToolWrenchIcon, TrashIcon, WidgetButton, type WidgetButtonProps, XCircleIcon, getToolIcon };