@iota-uz/sdk 0.4.23 → 0.4.24

package/dist/bichat/index.d.ts

@@ -72,19 +72,21 @@ interface ArtifactStore {
     deleteSessionArtifact(artifactId: string): Promise<void>;
 }
 interface AdminStore {
-    listUsers(): Promise<SessionUser[]>;
+    listUsers(): Promise<SessionUser$1[]>;
     listAllSessions(options?: {
         limit?: number;
         offset?: number;
         includeArchived?: boolean;
         userId?: string | null;
     }): Promise<{
-        sessions: Array<Session$1 & {
-            owner: SessionUser;
-        }>;
+        sessions: Session$1[];
         total: number;
         hasMore: boolean;
     }>;
+    listSessionMembers(sessionId: string): Promise<SessionMember$1[]>;
+    addSessionMember(sessionId: string, userId: string, role: 'editor' | 'viewer'): Promise<void>;
+    updateSessionMemberRole(sessionId: string, userId: string, role: 'editor' | 'viewer'): Promise<void>;
+    removeSessionMember(sessionId: string, userId: string): Promise<void>;
 }
 
 /**
@@ -97,6 +99,17 @@ interface Session$1 {
     pinned: boolean;
     createdAt: string;
     updatedAt: string;
+    owner?: SessionUser$1;
+    isGroup?: boolean;
+    memberCount?: number;
+    access?: SessionAccess$1;
+}
+interface SessionAccess$1 {
+    role: 'owner' | 'editor' | 'viewer' | 'read_all' | 'none';
+    source: 'owner' | 'member' | 'permission' | 'none';
+    canRead: boolean;
+    canWrite: boolean;
+    canManageMembers: boolean;
 }
 /**
  * A conversation turn groups a user message with its assistant response.
@@ -116,6 +129,7 @@ interface UserTurn$1 {
     id: string;
     content: string;
     attachments: Attachment$1[];
+    author?: SessionUser$1;
     createdAt: string;
 }
 /**
@@ -434,16 +448,16 @@ interface DebugTrace$1 {
     generationMs?: number;
     usage?: DebugUsage$1;
     tools: StreamToolPayload[];
-    attempts?: DebugGeneration[];
-    spans?: DebugSpan[];
-    events?: DebugEvent[];
+    attempts?: DebugGeneration$1[];
+    spans?: DebugSpan$1[];
+    events?: DebugEvent$1[];
     traceId?: string;
     traceUrl?: string;
     sessionId?: string;
     thinking?: string;
     observationReason?: string;
 }
-interface DebugGeneration {
+interface DebugGeneration$1 {
     id?: string;
     requestId?: string;
     model?: string;
@@ -463,7 +477,7 @@ interface DebugGeneration {
     completedAt?: string;
     toolCalls?: StreamToolPayload[];
 }
-interface DebugSpan {
+interface DebugSpan$1 {
     id?: string;
     parentId?: string;
     generationId?: string;
@@ -481,7 +495,7 @@ interface DebugSpan {
     completedAt?: string;
     attributes?: Record<string, unknown>;
 }
-interface DebugEvent {
+interface DebugEvent$1 {
     id?: string;
     name?: string;
     type?: string;
@@ -517,12 +531,18 @@ interface SessionListResult$1 {
     total: number;
     hasMore: boolean;
 }
-interface SessionUser {
+interface SessionUser$1 {
     id: string;
     firstName: string;
     lastName: string;
     initials: string;
 }
+interface SessionMember$1 {
+    user: SessionUser$1;
+    role: 'owner' | 'editor' | 'viewer';
+    createdAt: string;
+    updatedAt: string;
+}
 interface SessionGroup {
     name: string;
     sessions: Session$1[];
@@ -617,19 +637,21 @@ interface ChatDataSource {
     deleteSession(sessionId: string): Promise<void>;
     renameSession(sessionId: string, title: string): Promise<Session$1>;
     regenerateSessionTitle(sessionId: string): Promise<Session$1>;
-    listUsers?(): Promise<SessionUser[]>;
+    listUsers?(): Promise<SessionUser$1[]>;
     listAllSessions?(options?: {
         limit?: number;
         offset?: number;
         includeArchived?: boolean;
         userId?: string | null;
     }): Promise<{
-        sessions: Array<Session$1 & {
-            owner: SessionUser;
-        }>;
+        sessions: Session$1[];
         total: number;
         hasMore: boolean;
     }>;
+    listSessionMembers?(sessionId: string): Promise<SessionMember$1[]>;
+    addSessionMember?(sessionId: string, userId: string, role: 'editor' | 'viewer'): Promise<void>;
+    updateSessionMemberRole?(sessionId: string, userId: string, role: 'editor' | 'viewer'): Promise<void>;
+    removeSessionMember?(sessionId: string, userId: string): Promise<void>;
 }
 interface ChatSessionStateValue {
     session: Session$1 | null;
@@ -802,8 +824,16 @@ interface ChatHeaderProps {
     logoSlot?: ReactNode;
     /** Custom action buttons */
     actionsSlot?: ReactNode;
+    /** Members to display in avatar stack for group chats */
+    members?: Array<{
+        firstName: string;
+        lastName: string;
+        initials?: string;
+    }>;
+    /** Callback when avatar stack is clicked (to open members modal) */
+    onMembersClick?: () => void;
 }
-declare function ChatHeader({ session, onBack, readOnly, logoSlot, actionsSlot }: ChatHeaderProps): react_jsx_runtime.JSX.Element;
+declare function ChatHeader({ session, onBack, readOnly, logoSlot, actionsSlot, members, onMembersClick }: ChatHeaderProps): react_jsx_runtime.JSX.Element;
 
 interface MessageListProps {
     renderUserTurn?: (turn: ConversationTurn$1) => ReactNode;
@@ -876,6 +906,8 @@ interface UserMessageProps {
     turnId?: string;
     /** User initials for avatar */
     initials?: string;
+    /** Optional sender name for shared/group chats */
+    authorName?: string;
     /** Slot overrides */
     slots?: UserMessageSlots;
     /** Class name overrides */
@@ -893,7 +925,7 @@ interface UserMessageProps {
     /** Whether edit action should be available */
     allowEdit?: boolean;
 }
-declare function UserMessage({ turn, turnId, initials, slots, classNames: classNameOverrides, onCopy, onEdit, hideAvatar, hideActions, hideTimestamp, allowEdit, }: UserMessageProps): react_jsx_runtime.JSX.Element;
+declare function UserMessage({ turn, turnId, initials, authorName, slots, classNames: classNameOverrides, onCopy, onEdit, hideAvatar, hideActions, hideTimestamp, allowEdit, }: UserMessageProps): react_jsx_runtime.JSX.Element;
 
 interface UserTurnViewProps {
     /** The conversation turn containing the user message */
@@ -912,8 +944,10 @@ interface UserTurnViewProps {
     hideTimestamp?: boolean;
     /** Whether edit action should be available */
     allowEdit?: boolean;
+    /** Show sender identity label above the message bubble */
+    showAuthorName?: boolean;
 }
-declare function UserTurnView({ turn, slots, classNames, initials, hideAvatar, hideActions, hideTimestamp, allowEdit, }: UserTurnViewProps): react_jsx_runtime.JSX.Element;
+declare function UserTurnView({ turn, slots, classNames, initials, hideAvatar, hideActions, hideTimestamp, allowEdit, showAuthorName, }: UserTurnViewProps): react_jsx_runtime.JSX.Element;
 
 interface AssistantMessageAvatarSlotProps {
     /** Default text */
@@ -1655,13 +1689,45 @@ interface UserAvatarProps {
     /** Override initials (defaults to first letters of first and last name) */
     initials?: string;
     /** Avatar size */
-    size?: 'sm' | 'md' | 'lg';
+    size?: 'xs' | 'sm' | 'md' | 'lg';
     /** Additional CSS classes */
     className?: string;
 }
 declare function UserAvatar({ firstName, lastName, initials: providedInitials, size, className, }: UserAvatarProps): react_jsx_runtime.JSX.Element;
 declare const MemoizedUserAvatar: react.MemoExoticComponent<typeof UserAvatar>;
 
+/**
+ * AvatarStack Component
+ * Displays overlapping user avatars with an overflow "+N" indicator.
+ * Used in ChatHeader and SessionItem for group chat visualization.
+ */
+interface AvatarStackProps {
+    /** List of users to display */
+    users: Array<{
+        firstName: string;
+        lastName: string;
+        initials?: string;
+    }>;
+    /** Maximum avatars to show before "+N" (default: 3) */
+    max?: number;
+    /** Avatar size */
+    size?: 'xs' | 'sm';
+    /** Click handler — makes the stack interactive */
+    onClick?: () => void;
+    /** Additional CSS classes */
+    className?: string;
+}
+declare function AvatarStackInner({ users, max, size, onClick, className, }: AvatarStackProps): react_jsx_runtime.JSX.Element;
+declare const AvatarStack: react.MemoExoticComponent<typeof AvatarStackInner>;
+
+interface SessionMembersModalProps {
+    isOpen: boolean;
+    sessionId?: string;
+    dataSource: ChatDataSource;
+    onClose: () => void;
+}
+declare function SessionMembersModal({ isOpen, sessionId, dataSource, onClose }: SessionMembersModalProps): react_jsx_runtime.JSX.Element;
+
 interface PermissionGuardProps {
     /** Permission names to check */
     permissions: string[];
@@ -1797,9 +1863,9 @@ interface AllChatsListProps {
 declare function AllChatsList({ dataSource, onSessionSelect, activeSessionId }: AllChatsListProps): react_jsx_runtime.JSX.Element;
 
 interface UserFilterProps {
-    users: SessionUser[];
-    selectedUser: SessionUser | null;
-    onUserChange: (user: SessionUser | null) => void;
+    users: SessionUser$1[];
+    selectedUser: SessionUser$1 | null;
+    onUserChange: (user: SessionUser$1 | null) => void;
     loading?: boolean;
 }
 declare function UserFilter({ users, selectedUser, onUserChange, loading }: UserFilterProps): react_jsx_runtime.JSX.Element;
@@ -2627,672 +2693,127 @@ interface LongPressResult {
 }
 declare function useLongPress(options: LongPressOptions): LongPressResult;
 
-/**
- * Framer Motion animation variants for BiChat UI
- * Subtle, professional animations for enterprise applications
- *
- * Reduced-motion handling: Framer Motion's built-in `<MotionConfig reducedMotion="user">`
- * or the `useReducedMotion()` hook handle OS-level accessibility preferences reactively.
- * Variant objects declare their intended durations; Framer suppresses them automatically.
- */
-/**
- * Fade in animation
- */
-declare const fadeInVariants: {
-    initial: {
-        opacity: number;
+type BichatRPC = {
+    "bichat.artifact.delete": {
+        params: ArtifactIDParams;
+        result: OkResult;
     };
-    animate: {
-        opacity: number;
-        transition: {
-            duration: number;
-        };
+    "bichat.artifact.update": {
+        params: ArtifactUpdateParams;
+        result: ArtifactResult;
     };
-    exit: {
-        opacity: number;
-        transition: {
-            duration: number;
-        };
+    "bichat.ping": {
+        params: PingParams;
+        result: PingResult;
     };
-};
-/**
- * Fade in with subtle slide up
- */
-declare const fadeInUpVariants: {
-    initial: {
-        opacity: number;
-        y: number;
+    "bichat.question.reject": {
+        params: QuestionCancelParams;
+        result: SessionGetResult;
     };
-    animate: {
-        opacity: number;
-        y: number;
-        transition: {
-            duration: number;
-            ease: number[];
-        };
+    "bichat.question.submit": {
+        params: QuestionSubmitParams;
+        result: SessionGetResult;
     };
-    exit: {
-        opacity: number;
-        y: number;
-        transition: {
-            duration: number;
-        };
+    "bichat.session.archive": {
+        params: SessionIDParams;
+        result: SessionCreateResult;
     };
-};
-/**
- * Scale fade for modals and popups
- */
-declare const scaleFadeVariants: {
-    initial: {
-        opacity: number;
-        scale: number;
+    "bichat.session.artifacts": {
+        params: SessionArtifactsParams;
+        result: SessionArtifactsResult;
     };
-    animate: {
-        opacity: number;
-        scale: number;
-        transition: {
-            duration: number;
-        };
+    "bichat.session.clear": {
+        params: SessionIDParams;
+        result: SessionClearResult;
     };
-    exit: {
-        opacity: number;
-        scale: number;
-        transition: {
-            duration: number;
-        };
+    "bichat.session.compact": {
+        params: SessionIDParams;
+        result: SessionCompactResult;
     };
-};
-/**
- * Modal backdrop
- */
-declare const backdropVariants: {
-    initial: {
-        opacity: number;
+    "bichat.session.create": {
+        params: SessionCreateParams;
+        result: SessionCreateResult;
     };
-    animate: {
-        opacity: number;
-        transition: {
-            duration: number;
-        };
+    "bichat.session.delete": {
+        params: SessionIDParams;
+        result: OkResult;
     };
-    exit: {
-        opacity: number;
-        transition: {
-            duration: number;
-        };
+    "bichat.session.get": {
+        params: SessionGetParams;
+        result: SessionGetResult;
     };
-};
-/**
- * Button press feedback
- */
-declare const buttonVariants: {
-    tap: {
-        scale: number;
+    "bichat.session.list": {
+        params: SessionListParams;
+        result: SessionListResult;
     };
-};
-/**
- * Stagger container for lists
- */
-declare const staggerContainerVariants: {
-    hidden: {
-        opacity: number;
+    "bichat.session.listAll": {
+        params: SessionListAllParams;
+        result: SessionListAllResult;
     };
-    visible: {
-        opacity: number;
-        transition: {
-            staggerChildren: number;
-            delayChildren: number;
-        };
+    "bichat.session.members.add": {
+        params: SessionMembersUpsertParams;
+        result: OkResult;
     };
-};
-/**
- * List item animation
- */
-declare const listItemVariants: {
-    initial: {
-        opacity: number;
-        x: number;
+    "bichat.session.members.list": {
+        params: SessionMembersListParams;
+        result: SessionMembersListResult;
     };
-    animate: {
-        opacity: number;
-        x: number;
-        transition: {
-            duration: number;
-        };
+    "bichat.session.members.remove": {
+        params: SessionMembersRemoveParams;
+        result: OkResult;
     };
-    exit: {
-        opacity: number;
-        x: number;
-        transition: {
-            duration: number;
-        };
+    "bichat.session.members.updateRole": {
+        params: SessionMembersUpsertParams;
+        result: OkResult;
     };
-};
-/**
- * Message entrance animation
- */
-declare const messageVariants: {
-    initial: {
-        opacity: number;
-        y: number;
+    "bichat.session.pin": {
+        params: SessionIDParams;
+        result: SessionCreateResult;
     };
-    animate: {
-        opacity: number;
-        y: number;
-        transition: {
-            duration: number;
-            ease: number[];
-        };
+    "bichat.session.regenerateTitle": {
+        params: SessionIDParams;
+        result: SessionCreateResult;
     };
-    exit: {
-        opacity: number;
-        transition: {
-            duration: number;
-        };
+    "bichat.session.unarchive": {
+        params: SessionIDParams;
+        result: SessionCreateResult;
     };
-};
-/**
- * Container for staggered messages
- */
-declare const messageContainerVariants: {
-    initial: {
-        opacity: number;
+    "bichat.session.unpin": {
+        params: SessionIDParams;
+        result: SessionCreateResult;
     };
-    animate: {
-        opacity: number;
-        transition: {
-            staggerChildren: number;
-            delayChildren: number;
-        };
+    "bichat.session.updateTitle": {
+        params: SessionUpdateTitleParams;
+        result: SessionCreateResult;
     };
-};
-/**
- * Typing indicator dots
- */
-declare const typingDotVariants: {
-    initial: {
-        opacity: number;
+    "bichat.session.uploadArtifacts": {
+        params: SessionUploadArtifactsParams;
+        result: SessionUploadArtifactsResult;
     };
-    animate: {
-        opacity: number[];
-        transition: {
-            duration: number;
-            repeat: number;
-            ease: string;
-        };
-    };
-};
-/**
- * Verb transition for typing indicator
- * Smooth slide-up animation for rotating text
- */
-declare const verbTransitionVariants: {
-    initial: {
-        y: number;
-        opacity: number;
-    };
-    animate: {
-        y: number;
-        opacity: number;
-        transition: {
-            duration: number;
-            ease: string;
-        };
-    };
-    exit: {
-        y: number;
-        opacity: number;
-        transition: {
-            duration: number;
-        };
-    };
-};
-/**
- * Floating button (scroll to bottom, etc.)
- */
-declare const floatingButtonVariants: {
-    initial: {
-        opacity: number;
-        scale: number;
-    };
-    animate: {
-        opacity: number;
-        scale: number;
-        transition: {
-            duration: number;
-        };
-    };
-    exit: {
-        opacity: number;
-        scale: number;
-        transition: {
-            duration: number;
-        };
-    };
-};
-/**
- * Dropdown menu
- */
-declare const dropdownVariants: {
-    initial: {
-        opacity: number;
-        y: number;
-    };
-    animate: {
-        opacity: number;
-        y: number;
-        transition: {
-            duration: number;
-        };
-    };
-    exit: {
-        opacity: number;
-        y: number;
-        transition: {
-            duration: number;
-        };
-    };
-};
-/**
- * Session item with subtle slide-right on hover
- */
-declare const sessionItemVariants: {
-    initial: {
-        opacity: number;
-        x: number;
-    };
-    animate: {
-        opacity: number;
-        x: number;
-        transition: {
-            duration: number;
-        };
-    };
-    hover: {
-        x: number;
-        transition: {
-            duration: number;
-        };
-    };
-    exit: {
-        opacity: number;
-        x: number;
-        transition: {
-            duration: number;
-        };
-    };
-};
-/**
- * Error/alert message slide-in
- */
-declare const errorMessageVariants: {
-    initial: {
-        opacity: number;
-        y: number;
-        height: number;
-    };
-    animate: {
-        opacity: number;
-        y: number;
-        height: string;
-        transition: {
-            duration: number;
-            ease: number[];
-        };
-    };
-    exit: {
-        opacity: number;
-        y: number;
-        height: number;
-        transition: {
-            duration: number;
-        };
+    "bichat.user.list": {
+        params: PingParams;
+        result: UserListResult;
     };
 };
-
-interface ChatSessionProviderProps {
-    dataSource: ChatDataSource;
-    sessionId?: string;
-    /**
-     * External rate limiter instance. Captured once at mount — changing this prop
-     * after initial render has no effect. For most cases, use `rateLimitConfig`
-     * instead and let the provider create the limiter internally.
-     */
-    rateLimiter?: RateLimiter;
-    /**
-     * Configuration for the built-in rate limiter (ignored when `rateLimiter` is
-     * provided). Captured once at mount — changing after initial render has no effect.
-     */
-    rateLimitConfig?: RateLimiterConfig;
-    /**
-     * Called when the machine creates a new session (e.g. on first message in a
-     * "new chat"). Use this to navigate your SPA router to the new session URL.
-     *
-     * Replaces the deprecated `dataSource.navigateToSession`.
-     */
-    onSessionCreated?: (sessionId: string) => void;
-    children: ReactNode;
+interface Artifact {
+    id: string;
+    sessionId: string;
+    messageId?: string;
+    uploadId?: number | null;
+    type: string;
+    name: string;
+    description?: string;
+    mimeType?: string;
+    url?: string;
+    sizeBytes: number;
+    metadata?: Record<string, unknown>;
+    createdAt: string;
 }
-declare function ChatSessionProvider({ dataSource, sessionId, rateLimiter: externalRateLimiter, rateLimitConfig, onSessionCreated, children, }: ChatSessionProviderProps): react_jsx_runtime.JSX.Element;
-declare function useChatSession(): ChatSessionStateValue;
-declare function useChatMessaging(): ChatMessagingStateValue;
-/** Returns messaging context or null when outside ChatSessionProvider. */
-declare function useOptionalChatMessaging(): ChatMessagingStateValue | null;
-declare function useChatInput(): ChatInputStateValue;
-
-/**
- * BiChat context types layered on top of canonical applet-core context contracts.
- */
-
-type UserContext = UserContext$1;
-type TenantContext = TenantContext$1;
-type LocaleContext = LocaleContext$1;
-type AppConfig = AppConfig$1 & {
-    streamEndpoint: string;
-    basePath: string;
-    assetsBasePath: string;
-    rpcUIEndpoint: string;
-};
-interface Extensions {
-    branding?: {
-        appName?: string;
-        logoUrl?: string;
-        theme?: {
-            primary?: string;
-            secondary?: string;
-            accent?: string;
-        };
-        welcome?: {
-            title?: string;
-            description?: string;
-            examplePrompts?: Array<{
-                category: string;
-                text: string;
-                icon: string;
-            }>;
-        };
-        colors?: {
-            primary?: string;
-            secondary?: string;
-            accent?: string;
-        };
-        logo?: {
-            src?: string;
-            alt?: string;
-        };
-    };
-    features?: {
-        vision?: boolean;
-        webSearch?: boolean;
-        codeInterpreter?: boolean;
-        multiAgent?: boolean;
-    };
-    llm?: {
-        provider?: string;
-        apiKeyConfigured?: boolean;
-    };
-    debug?: {
-        limits?: {
-            policyMaxTokens: number;
-            modelMaxTokens: number;
-            effectiveMaxTokens: number;
-            completionReserveTokens: number;
-        };
-    };
+interface ArtifactIDParams {
+    id: string;
 }
-type IotaContext = Omit<InitialContext, 'config' | 'extensions'> & {
-    config: AppConfig;
-    extensions?: Extensions;
-};
-declare global {
-    interface Window {
-        __APPLET_CONTEXT__: IotaContext;
-        __CSRF_TOKEN__: string;
-    }
-}
-
-interface IotaContextProviderProps {
-    /**
-     * Explicit context object. When provided, the window global is not read.
-     * Useful for tests, Storybook, or apps that manage their own context.
-     */
-    context?: IotaContext;
-    children: ReactNode;
-}
-declare function IotaContextProvider({ context, children }: IotaContextProviderProps): react_jsx_runtime.JSX.Element;
-declare function useIotaContext(): IotaContext;
-/**
- * Check if user has a specific permission
- */
-declare function hasPermission(permission: string): boolean;
-
-/** @deprecated Use `IotaContextProvider` with its `context` prop instead. */
-interface BiChatConfig {
-    user: {
-        id: string;
-        email: string;
-        firstName: string;
-        lastName: string;
-        permissions: string[];
-    };
-    tenant: {
-        id: string;
-        name: string;
-    };
-    locale: {
-        language: string;
-        translations: Record<string, string>;
-    };
-    endpoints: {
-        rpc: string;
-        stream: string;
-    };
-    csrfToken?: string;
-}
-interface ConfigProviderProps {
-    config?: BiChatConfig;
-    useGlobalConfig?: boolean;
-    children: ReactNode;
-}
-/**
- * @deprecated Use `IotaContextProvider` with its `context` prop instead.
- *
- * ConfigProvider component — provides configuration to the BiChat library.
- *
- * @param config - Configuration object (preferred method)
- * @param useGlobalConfig - If true, falls back to window.__APPLET_CONTEXT__ when config is not provided
- * @param children - React children
- */
-declare function ConfigProvider({ config, useGlobalConfig, children }: ConfigProviderProps): react_jsx_runtime.JSX.Element;
-/**
- * Hook to access BiChat configuration
- * Returns null if no configuration is available
- */
-declare function useConfig(): BiChatConfig | null;
-/**
- * Hook to access BiChat configuration (required)
- * Throws an error if configuration is not available
- */
-declare function useRequiredConfig(): BiChatConfig;
-
-/**
- * Theme system type definitions
- */
-interface Theme {
-    name: string;
-    colors: ThemeColors;
-    spacing: ThemeSpacing;
-    borderRadius: ThemeBorderRadius;
-}
-interface ThemeColors {
-    background: string;
-    surface: string;
-    primary: string;
-    secondary: string;
-    text: string;
-    textMuted: string;
-    border: string;
-    error: string;
-    success: string;
-    warning: string;
-    userBubble: string;
-    assistantBubble: string;
-    userText: string;
-    assistantText: string;
-}
-interface ThemeSpacing {
-    xs: string;
-    sm: string;
-    md: string;
-    lg: string;
-    xl: string;
-}
-interface ThemeBorderRadius {
-    sm: string;
-    md: string;
-    lg: string;
-    full: string;
-}
-
-interface ThemeProviderProps {
-    theme?: Theme | 'light' | 'dark' | 'system';
-    children: ReactNode;
-}
-/**
- * Theme provider component
- * Wraps the application and provides theme context
- */
-declare function ThemeProvider({ theme, children }: ThemeProviderProps): react_jsx_runtime.JSX.Element;
-/**
- * Hook to access current theme
- */
-declare function useTheme(): Theme;
-
-/**
- * Predefined theme configurations
- */
-
-declare const lightTheme: Theme;
-declare const darkTheme: Theme;
-
-/**
- * CSRF token management for API requests
- */
-/**
- * Get CSRF token from window object
- * @returns CSRF token string
- */
-declare function getCSRFToken(): string;
-/**
- * Add CSRF token to request headers
- * @param headers - Headers object to modify
- * @returns Modified headers object
- */
-declare function addCSRFHeader(headers: Headers): Headers;
-/**
- * Create headers with CSRF token
- * @param init - Optional initial headers
- * @returns Headers object with CSRF token
- */
-declare function createHeadersWithCSRF(init?: HeadersInit): Headers;
-
-type BichatRPC = {
-    "bichat.artifact.delete": {
-        params: ArtifactIDParams;
-        result: OkResult;
-    };
-    "bichat.artifact.update": {
-        params: ArtifactUpdateParams;
-        result: ArtifactResult;
-    };
-    "bichat.ping": {
-        params: PingParams;
-        result: PingResult;
-    };
-    "bichat.question.reject": {
-        params: QuestionCancelParams;
-        result: SessionGetResult;
-    };
-    "bichat.question.submit": {
-        params: QuestionSubmitParams;
-        result: SessionGetResult;
-    };
-    "bichat.session.archive": {
-        params: SessionIDParams;
-        result: SessionCreateResult;
-    };
-    "bichat.session.artifacts": {
-        params: SessionArtifactsParams;
-        result: SessionArtifactsResult;
-    };
-    "bichat.session.clear": {
-        params: SessionIDParams;
-        result: SessionClearResult;
-    };
-    "bichat.session.compact": {
-        params: SessionIDParams;
-        result: SessionCompactResult;
-    };
-    "bichat.session.create": {
-        params: SessionCreateParams;
-        result: SessionCreateResult;
-    };
-    "bichat.session.delete": {
-        params: SessionIDParams;
-        result: OkResult;
-    };
-    "bichat.session.get": {
-        params: SessionGetParams;
-        result: SessionGetResult;
-    };
-    "bichat.session.list": {
-        params: SessionListParams;
-        result: SessionListResult;
-    };
-    "bichat.session.pin": {
-        params: SessionIDParams;
-        result: SessionCreateResult;
-    };
-    "bichat.session.regenerateTitle": {
-        params: SessionIDParams;
-        result: SessionCreateResult;
-    };
-    "bichat.session.unarchive": {
-        params: SessionIDParams;
-        result: SessionCreateResult;
-    };
-    "bichat.session.unpin": {
-        params: SessionIDParams;
-        result: SessionCreateResult;
-    };
-    "bichat.session.updateTitle": {
-        params: SessionUpdateTitleParams;
-        result: SessionCreateResult;
-    };
-    "bichat.session.uploadArtifacts": {
-        params: SessionUploadArtifactsParams;
-        result: SessionUploadArtifactsResult;
-    };
-};
-interface Artifact {
-    id: string;
-    sessionId: string;
-    messageId?: string;
-    uploadId?: number;
-    type: string;
-    name: string;
-    description?: string;
-    mimeType?: string;
-    url?: string;
-    sizeBytes: number;
-    metadata?: Record<string, unknown>;
-    createdAt: string;
-}
-interface ArtifactIDParams {
-    id: string;
-}
-interface ArtifactResult {
-    artifact: Artifact;
+interface ArtifactResult {
+    artifact: Artifact;
 }
 interface ArtifactUpdateParams {
     id: string;
@@ -3312,11 +2833,11 @@ interface AssistantTurn {
     createdAt: string;
 }
 interface Attachment {
-    id?: string;
-    uploadId?: number;
-    filename?: string;
-    mimeType?: string;
-    sizeBytes?: number;
+    id: string;
+    uploadId?: number | null;
+    filename: string;
+    mimeType: string;
+    sizeBytes: number;
     url?: string;
 }
 interface Citation {
@@ -3327,6 +2848,7 @@ interface Citation {
     startIndex: number;
     endIndex: number;
     excerpt?: string;
+    source?: string;
 }
 interface CodeOutput {
     type: string;
@@ -3342,20 +2864,79 @@ interface ConversationTurn {
     assistantTurn?: AssistantTurn | null;
     createdAt: string;
 }
-interface DebugToolCall {
-    callId?: string;
+interface DebugEvent {
+    id?: string;
     name?: string;
-    arguments?: string;
-    result?: string;
-    error?: string;
-    durationMs?: number;
-}
-interface DebugTrace {
-    usage?: DebugUsage | null;
+    type?: string;
+    level?: string;
+    message?: string;
+    reason?: string;
+    spanId?: string;
+    generationId?: string;
+    timestamp?: string;
+    attributes?: Record<string, unknown>;
+}
+interface DebugGeneration {
+    id?: string;
+    requestId?: string;
+    model?: string;
+    provider?: string;
+    finishReason?: string;
+    promptTokens?: number;
+    completionTokens?: number;
+    totalTokens?: number;
+    cachedTokens?: number;
+    cost?: number;
+    latencyMs?: number;
+    input?: string;
+    output?: string;
+    thinking?: string;
+    observationReason?: string;
+    startedAt?: string;
+    completedAt?: string;
+    toolCalls?: DebugToolCall[];
+}
+interface DebugSpan {
+    id?: string;
+    parentId?: string;
+    generationId?: string;
+    name?: string;
+    type?: string;
+    status?: string;
+    level?: string;
+    callId?: string;
+    toolName?: string;
+    input?: string;
+    output?: string;
+    error?: string;
+    durationMs?: number;
+    startedAt?: string;
+    completedAt?: string;
+    attributes?: Record<string, unknown>;
+}
+interface DebugToolCall {
+    callId?: string;
+    name?: string;
+    arguments?: string;
+    result?: string;
+    error?: string;
+    durationMs?: number;
+}
+interface DebugTrace {
+    schemaVersion?: string;
+    startedAt?: string;
+    completedAt?: string;
+    usage?: DebugUsage | null;
     generationMs?: number;
     tools?: DebugToolCall[];
+    attempts?: DebugGeneration[];
+    spans?: DebugSpan[];
+    events?: DebugEvent[];
     traceId?: string;
     traceUrl?: string;
+    sessionId?: string;
+    thinking?: string;
+    observationReason?: string;
 }
 interface DebugUsage {
     promptTokens: number;
@@ -3403,6 +2984,17 @@ interface Session {
     pinned: boolean;
     createdAt: string;
     updatedAt: string;
+    owner?: SessionUser | null;
+    isGroup?: boolean;
+    memberCount?: number;
+    access?: SessionAccess | null;
+}
+interface SessionAccess {
+    role: string;
+    source: string;
+    canRead: boolean;
+    canWrite: boolean;
+    canManageMembers: boolean;
 }
 interface SessionArtifactsParams {
     sessionId: string;
@@ -3442,6 +3034,17 @@ interface SessionGetResult {
 interface SessionIDParams {
     id: string;
 }
+interface SessionListAllParams {
+    limit: number;
+    offset: number;
+    includeArchived: boolean;
+    userId?: string | null;
+}
+interface SessionListAllResult {
+    sessions: Session[];
+    total?: number;
+    hasMore: boolean;
+}
 interface SessionListParams {
     limit: number;
     offset: number;
@@ -3452,6 +3055,27 @@ interface SessionListResult {
     total?: number;
     hasMore: boolean;
 }
+interface SessionMember {
+    user: SessionUser;
+    role: string;
+    createdAt: string;
+    updatedAt: string;
+}
+interface SessionMembersListParams {
+    sessionId: string;
+}
+interface SessionMembersListResult {
+    members: SessionMember[];
+}
+interface SessionMembersRemoveParams {
+    sessionId: string;
+    userId: string;
+}
+interface SessionMembersUpsertParams {
+    sessionId: string;
+    userId: string;
+    role: string;
+}
 interface SessionUpdateTitleParams {
     id: string;
     title: string;
@@ -3463,6 +3087,12 @@ interface SessionUploadArtifactsParams {
 interface SessionUploadArtifactsResult {
     artifacts: Artifact[];
 }
+interface SessionUser {
+    id: string;
+    firstName: string;
+    lastName: string;
+    initials: string;
+}
 interface ToolCall {
     id: string;
     name: string;
@@ -3471,130 +3101,772 @@ interface ToolCall {
     error?: string;
     durationMs?: number;
 }
-interface UserTurn {
-    id: string;
-    content: string;
-    attachments: Attachment[];
-    createdAt: string;
+interface UserListResult {
+    users: SessionUser[];
+}
+interface UserTurn {
+    id: string;
+    content: string;
+    attachments: Attachment[];
+    author?: SessionUser | null;
+    createdAt: string;
+}
+
+/**
+ * Session lifecycle management: create, list, get, delete, archive, pin, rename.
+ *
+ * @internal — Not part of the public API. Consumed by HttpDataSource.
+ */
+
+interface SessionState {
+    session: Session$1;
+    turns: ConversationTurn$1[];
+    pendingQuestion?: PendingQuestion$1 | null;
+}
+
+/**
+ * Built-in HTTP data source with SSE streaming and AbortController
+ * Implements ChatDataSource interface with real HTTP/RPC calls
+ *
+ * Uses turn-based architecture - fetches ConversationTurns instead of flat messages.
+ *
+ * This file is a thin facade that delegates to focused internal modules:
+ *   - SessionManager.ts  — session CRUD (create, list, get, delete, archive, pin)
+ *   - MessageTransport.ts — send messages, stream responses, HITL questions
+ *   - ArtifactManager.ts  — artifact fetch, upload, rename, delete
+ *   - AttachmentUploader.ts — file decode, normalize, upload
+ *   - mappers.ts          — RPC-to-domain type mapping and sanitization
+ */
+
+interface HttpDataSourceConfig {
+    baseUrl: string;
+    rpcEndpoint: string;
+    streamEndpoint?: string;
+    uploadEndpoint?: string;
+    csrfToken?: string | (() => string);
+    headers?: Record<string, string>;
+    timeout?: number;
+    /**
+     * @deprecated Pass `onSessionCreated` to `ChatSessionProvider` or
+     * `ChatSession` instead. Coupling navigation to the data source causes
+     * component remounts during active streams.
+     */
+    navigateToSession?: (sessionId: string) => void;
+}
+declare class HttpDataSource implements ChatDataSource {
+    private config;
+    private abortController;
+    private rpc;
+    constructor(config: HttpDataSourceConfig);
+    private getCSRFToken;
+    private createHeaders;
+    private createUploadHeaders;
+    private callRPC;
+    private boundCallRPC;
+    private boundUploadFile;
+    createSession(): Promise<Session$1>;
+    fetchSession(id: string): Promise<SessionState | null>;
+    listSessions(options?: {
+        limit?: number;
+        offset?: number;
+        includeArchived?: boolean;
+    }): Promise<SessionListResult$1>;
+    archiveSession(sessionId: string): Promise<Session$1>;
+    unarchiveSession(sessionId: string): Promise<Session$1>;
+    pinSession(sessionId: string): Promise<Session$1>;
+    unpinSession(sessionId: string): Promise<Session$1>;
+    deleteSession(sessionId: string): Promise<void>;
+    renameSession(sessionId: string, title: string): Promise<Session$1>;
+    regenerateSessionTitle(sessionId: string): Promise<Session$1>;
+    clearSessionHistory(sessionId: string): Promise<{
+        success: boolean;
+        deletedMessages: number;
+        deletedArtifacts: number;
+    }>;
+    compactSessionHistory(sessionId: string): Promise<{
+        success: boolean;
+        summary: string;
+        deletedMessages: number;
+        deletedArtifacts: number;
+    }>;
+    listUsers(): Promise<SessionUser$1[]>;
+    listAllSessions(options?: {
+        limit?: number;
+        offset?: number;
+        includeArchived?: boolean;
+        userId?: string | null;
+    }): Promise<{
+        sessions: Session$1[];
+        total: number;
+        hasMore: boolean;
+    }>;
+    listSessionMembers(sessionId: string): Promise<SessionMember$1[]>;
+    addSessionMember(sessionId: string, userId: string, role: 'editor' | 'viewer'): Promise<void>;
+    updateSessionMemberRole(sessionId: string, userId: string, role: 'editor' | 'viewer'): Promise<void>;
+    removeSessionMember(sessionId: string, userId: string): Promise<void>;
+    stopGeneration(sessionId: string): Promise<void>;
+    getStreamStatus(sessionId: string): Promise<StreamStatus | null>;
+    resumeStream(sessionId: string, runId: string, onChunk: (chunk: StreamChunk) => void, signal?: AbortSignal): Promise<void>;
+    sendMessage(sessionId: string, content: string, attachments?: Attachment$1[], signal?: AbortSignal, options?: SendMessageOptions): AsyncGenerator<StreamChunk>;
+    cancelStream(): void;
+    submitQuestionAnswers(sessionId: string, questionId: string, answers: QuestionAnswers): Promise<{
+        success: boolean;
+        error?: string;
+        data?: {
+            session: Session$1;
+            turns: ConversationTurn$1[];
+            pendingQuestion?: PendingQuestion$1 | null;
+        };
+    }>;
+    rejectPendingQuestion(sessionId: string): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    fetchSessionArtifacts(sessionId: string, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        artifacts: SessionArtifact[];
+        hasMore?: boolean;
+        nextOffset?: number;
+    }>;
+    uploadSessionArtifacts(sessionId: string, files: File[]): Promise<{
+        artifacts: SessionArtifact[];
+    }>;
+    renameSessionArtifact(artifactId: string, name: string, description?: string): Promise<SessionArtifact>;
+    deleteSessionArtifact(artifactId: string): Promise<void>;
+    /**
+     * @deprecated Pass `onSessionCreated` to `ChatSessionProvider` instead.
+     */
+    navigateToSession?(sessionId: string): void;
+}
+/**
+ * Factory function to create HttpDataSource
+ */
+declare function createHttpDataSource(config: HttpDataSourceConfig): ChatDataSource;
+
+/**
+ * Builds HttpDataSourceConfig from window.__APPLET_CONTEXT__.
+ * For use with createHttpDataSource when the app is embedded via the applet framework.
+ *
+ * Expects the host to inject context with:
+ * - config.rpcUIEndpoint, config.streamEndpoint
+ * - session.csrfToken (or window.__CSRF_TOKEN__)
+ */
+
+/**
+ * Returns HttpDataSourceConfig derived from window.__APPLET_CONTEXT__.
+ * Use with createHttpDataSource() for RPC and SSE endpoints.
+ *
+ * @throws Error if window.__APPLET_CONTEXT__ is not available
+ */
+declare function useHttpDataSourceConfigFromApplet(options?: {
+    timeout?: number;
+}): HttpDataSourceConfig;
+
+/**
+ * Router adapter for BiChat sidebar and archived list.
+ * Consumes a navigate function and location (pathname) and returns
+ * activeSessionId plus callbacks for use with SDK Sidebar and ArchivedChatList.
+ *
+ * Router-agnostic: pass useNavigate()/useLocation() from react-router-dom
+ * or equivalent from your router.
+ */
+interface UseBichatRouterParams {
+    /** Navigate to a path (e.g. from useNavigate()) */
+    navigate: (path: string) => void;
+    /** Current pathname (e.g. location.pathname from useLocation()) */
+    pathname: string;
+    /** Optional: close mobile sidebar after navigation (e.g. closeMobile from useSidebarState) */
+    onNavigate?: () => void;
+}
+interface UseBichatRouterReturn {
+    /** Session ID extracted from pathname (e.g. /session/:id -> id) */
+    activeSessionId: string | undefined;
+    /** Navigate to session or home when sessionId is empty */
+    onSessionSelect: (sessionId: string) => void;
+    /** Navigate to new chat (home) */
+    onNewChat: () => void;
+    /** Navigate to archived list */
+    onArchivedView: () => void;
+    /** Navigate back (e.g. to home) */
+    onBack: () => void;
+}
+/**
+ * Derives BiChat navigation callbacks and activeSessionId from router state.
+ * Use with SDK Sidebar (onSessionSelect, onNewChat, onArchivedView, activeSessionId)
+ * and ArchivedChatList (onBack, onSessionSelect).
+ */
+declare function useBichatRouter({ navigate, pathname, onNavigate, }: UseBichatRouterParams): UseBichatRouterReturn;
+
+/**
+ * Framer Motion animation variants for BiChat UI
+ * Subtle, professional animations for enterprise applications
+ *
+ * Reduced-motion handling: Framer Motion's built-in `<MotionConfig reducedMotion="user">`
+ * or the `useReducedMotion()` hook handle OS-level accessibility preferences reactively.
+ * Variant objects declare their intended durations; Framer suppresses them automatically.
+ */
+/**
+ * Fade in animation
+ */
+declare const fadeInVariants: {
+    initial: {
+        opacity: number;
+    };
+    animate: {
+        opacity: number;
+        transition: {
+            duration: number;
+        };
+    };
+    exit: {
+        opacity: number;
+        transition: {
+            duration: number;
+        };
+    };
+};
+/**
+ * Fade in with subtle slide up
+ */
+declare const fadeInUpVariants: {
+    initial: {
+        opacity: number;
+        y: number;
+    };
+    animate: {
+        opacity: number;
+        y: number;
+        transition: {
+            duration: number;
+            ease: number[];
+        };
+    };
+    exit: {
+        opacity: number;
+        y: number;
+        transition: {
+            duration: number;
+        };
+    };
+};
+/**
+ * Scale fade for modals and popups
+ */
+declare const scaleFadeVariants: {
+    initial: {
+        opacity: number;
+        scale: number;
+    };
+    animate: {
+        opacity: number;
+        scale: number;
+        transition: {
+            duration: number;
+        };
+    };
+    exit: {
+        opacity: number;
+        scale: number;
+        transition: {
+            duration: number;
+        };
+    };
+};
+/**
+ * Modal backdrop
+ */
+declare const backdropVariants: {
+    initial: {
+        opacity: number;
+    };
+    animate: {
+        opacity: number;
+        transition: {
+            duration: number;
+        };
+    };
+    exit: {
+        opacity: number;
+        transition: {
+            duration: number;
+        };
+    };
+};
+/**
+ * Button press feedback
+ */
+declare const buttonVariants: {
+    tap: {
+        scale: number;
+    };
+};
+/**
+ * Stagger container for lists
+ */
+declare const staggerContainerVariants: {
+    hidden: {
+        opacity: number;
+    };
+    visible: {
+        opacity: number;
+        transition: {
+            staggerChildren: number;
+            delayChildren: number;
+        };
+    };
+};
+/**
+ * List item animation
+ */
+declare const listItemVariants: {
+    initial: {
+        opacity: number;
+        x: number;
+    };
+    animate: {
+        opacity: number;
+        x: number;
+        transition: {
+            duration: number;
+        };
+    };
+    exit: {
+        opacity: number;
+        x: number;
+        transition: {
+            duration: number;
+        };
+    };
+};
+/**
+ * Message entrance animation
+ */
+declare const messageVariants: {
+    initial: {
+        opacity: number;
+        y: number;
+    };
+    animate: {
+        opacity: number;
+        y: number;
+        transition: {
+            duration: number;
+            ease: number[];
+        };
+    };
+    exit: {
+        opacity: number;
+        transition: {
+            duration: number;
+        };
+    };
+};
+/**
+ * Container for staggered messages
+ */
+declare const messageContainerVariants: {
+    initial: {
+        opacity: number;
+    };
+    animate: {
+        opacity: number;
+        transition: {
+            staggerChildren: number;
+            delayChildren: number;
+        };
+    };
+};
+/**
+ * Typing indicator dots
+ */
+declare const typingDotVariants: {
+    initial: {
+        opacity: number;
+    };
+    animate: {
+        opacity: number[];
+        transition: {
+            duration: number;
+            repeat: number;
+            ease: string;
+        };
+    };
+};
+/**
+ * Verb transition for typing indicator
+ * Smooth slide-up animation for rotating text
+ */
+declare const verbTransitionVariants: {
+    initial: {
+        y: number;
+        opacity: number;
+    };
+    animate: {
+        y: number;
+        opacity: number;
+        transition: {
+            duration: number;
+            ease: string;
+        };
+    };
+    exit: {
+        y: number;
+        opacity: number;
+        transition: {
+            duration: number;
+        };
+    };
+};
+/**
+ * Floating button (scroll to bottom, etc.)
+ */
+declare const floatingButtonVariants: {
+    initial: {
+        opacity: number;
+        scale: number;
+    };
+    animate: {
+        opacity: number;
+        scale: number;
+        transition: {
+            duration: number;
+        };
+    };
+    exit: {
+        opacity: number;
+        scale: number;
+        transition: {
+            duration: number;
+        };
+    };
+};
+/**
+ * Dropdown menu
+ */
+declare const dropdownVariants: {
+    initial: {
+        opacity: number;
+        y: number;
+    };
+    animate: {
+        opacity: number;
+        y: number;
+        transition: {
+            duration: number;
+        };
+    };
+    exit: {
+        opacity: number;
+        y: number;
+        transition: {
+            duration: number;
+        };
+    };
+};
+/**
+ * Session item with subtle slide-right on hover
+ */
+declare const sessionItemVariants: {
+    initial: {
+        opacity: number;
+        x: number;
+    };
+    animate: {
+        opacity: number;
+        x: number;
+        transition: {
+            duration: number;
+        };
+    };
+    hover: {
+        x: number;
+        transition: {
+            duration: number;
+        };
+    };
+    exit: {
+        opacity: number;
+        x: number;
+        transition: {
+            duration: number;
+        };
+    };
+};
+/**
+ * Error/alert message slide-in
+ */
+declare const errorMessageVariants: {
+    initial: {
+        opacity: number;
+        y: number;
+        height: number;
+    };
+    animate: {
+        opacity: number;
+        y: number;
+        height: string;
+        transition: {
+            duration: number;
+            ease: number[];
+        };
+    };
+    exit: {
+        opacity: number;
+        y: number;
+        height: number;
+        transition: {
+            duration: number;
+        };
+    };
+};
+
+interface ChatSessionProviderProps {
+    dataSource: ChatDataSource;
+    sessionId?: string;
+    /**
+     * External rate limiter instance. Captured once at mount — changing this prop
+     * after initial render has no effect. For most cases, use `rateLimitConfig`
+     * instead and let the provider create the limiter internally.
+     */
+    rateLimiter?: RateLimiter;
+    /**
+     * Configuration for the built-in rate limiter (ignored when `rateLimiter` is
+     * provided). Captured once at mount — changing after initial render has no effect.
+     */
+    rateLimitConfig?: RateLimiterConfig;
+    /**
+     * Called when the machine creates a new session (e.g. on first message in a
+     * "new chat"). Use this to navigate your SPA router to the new session URL.
+     *
+     * Replaces the deprecated `dataSource.navigateToSession`.
+     */
+    onSessionCreated?: (sessionId: string) => void;
+    children: ReactNode;
+}
+declare function ChatSessionProvider({ dataSource, sessionId, rateLimiter: externalRateLimiter, rateLimitConfig, onSessionCreated, children, }: ChatSessionProviderProps): react_jsx_runtime.JSX.Element;
+declare function useChatSession(): ChatSessionStateValue;
+declare function useChatMessaging(): ChatMessagingStateValue;
+/** Returns messaging context or null when outside ChatSessionProvider. */
+declare function useOptionalChatMessaging(): ChatMessagingStateValue | null;
+declare function useChatInput(): ChatInputStateValue;
+
+/**
+ * BiChat context types layered on top of canonical applet-core context contracts.
+ */
+
+type UserContext = UserContext$1;
+type TenantContext = TenantContext$1;
+type LocaleContext = LocaleContext$1;
+type AppConfig = AppConfig$1 & {
+    streamEndpoint: string;
+    basePath: string;
+    assetsBasePath: string;
+    rpcUIEndpoint: string;
+};
+interface Extensions {
+    branding?: {
+        appName?: string;
+        logoUrl?: string;
+        theme?: {
+            primary?: string;
+            secondary?: string;
+            accent?: string;
+        };
+        welcome?: {
+            title?: string;
+            description?: string;
+            examplePrompts?: Array<{
+                category: string;
+                text: string;
+                icon: string;
+            }>;
+        };
+        colors?: {
+            primary?: string;
+            secondary?: string;
+            accent?: string;
+        };
+        logo?: {
+            src?: string;
+            alt?: string;
+        };
+    };
+    features?: {
+        vision?: boolean;
+        webSearch?: boolean;
+        codeInterpreter?: boolean;
+        multiAgent?: boolean;
+    };
+    llm?: {
+        provider?: string;
+        apiKeyConfigured?: boolean;
+    };
+    debug?: {
+        limits?: {
+            policyMaxTokens: number;
+            modelMaxTokens: number;
+            effectiveMaxTokens: number;
+            completionReserveTokens: number;
+        };
+    };
+}
+type IotaContext = Omit<InitialContext, 'config' | 'extensions'> & {
+    config: AppConfig;
+    extensions?: Extensions;
+};
+declare global {
+    interface Window {
+        __APPLET_CONTEXT__: IotaContext;
+        __CSRF_TOKEN__: string;
+    }
 }
 
+interface IotaContextProviderProps {
+    /**
+     * Explicit context object. When provided, the window global is not read.
+     * Useful for tests, Storybook, or apps that manage their own context.
+     */
+    context?: IotaContext;
+    children: ReactNode;
+}
+declare function IotaContextProvider({ context, children }: IotaContextProviderProps): react_jsx_runtime.JSX.Element;
+declare function useIotaContext(): IotaContext;
 /**
- * Session lifecycle management: create, list, get, delete, archive, pin, rename.
- *
- * @internal — Not part of the public API. Consumed by HttpDataSource.
+ * Check if user has a specific permission
  */
+declare function hasPermission(permission: string): boolean;
 
-interface SessionState {
-    session: Session$1;
-    turns: ConversationTurn$1[];
-    pendingQuestion?: PendingQuestion$1 | null;
+/** @deprecated Use `IotaContextProvider` with its `context` prop instead. */
+interface BiChatConfig {
+    user: {
+        id: string;
+        email: string;
+        firstName: string;
+        lastName: string;
+        permissions: string[];
+    };
+    tenant: {
+        id: string;
+        name: string;
+    };
+    locale: {
+        language: string;
+        translations: Record<string, string>;
+    };
+    endpoints: {
+        rpc: string;
+        stream: string;
+    };
+    csrfToken?: string;
+}
+interface ConfigProviderProps {
+    config?: BiChatConfig;
+    useGlobalConfig?: boolean;
+    children: ReactNode;
 }
-
 /**
- * Built-in HTTP data source with SSE streaming and AbortController
- * Implements ChatDataSource interface with real HTTP/RPC calls
+ * @deprecated Use `IotaContextProvider` with its `context` prop instead.
  *
- * Uses turn-based architecture - fetches ConversationTurns instead of flat messages.
+ * ConfigProvider component — provides configuration to the BiChat library.
  *
- * This file is a thin facade that delegates to focused internal modules:
- *   - SessionManager.ts  — session CRUD (create, list, get, delete, archive, pin)
- *   - MessageTransport.ts — send messages, stream responses, HITL questions
- *   - ArtifactManager.ts  — artifact fetch, upload, rename, delete
- *   - AttachmentUploader.ts — file decode, normalize, upload
- *   - mappers.ts          — RPC-to-domain type mapping and sanitization
+ * @param config - Configuration object (preferred method)
+ * @param useGlobalConfig - If true, falls back to window.__APPLET_CONTEXT__ when config is not provided
+ * @param children - React children
+ */
+declare function ConfigProvider({ config, useGlobalConfig, children }: ConfigProviderProps): react_jsx_runtime.JSX.Element;
+/**
+ * Hook to access BiChat configuration
+ * Returns null if no configuration is available
+ */
+declare function useConfig(): BiChatConfig | null;
+/**
+ * Hook to access BiChat configuration (required)
+ * Throws an error if configuration is not available
  */
+declare function useRequiredConfig(): BiChatConfig;
 
-interface HttpDataSourceConfig {
-    baseUrl: string;
-    rpcEndpoint: string;
-    streamEndpoint?: string;
-    uploadEndpoint?: string;
-    csrfToken?: string | (() => string);
-    headers?: Record<string, string>;
-    timeout?: number;
-    /**
-     * @deprecated Pass `onSessionCreated` to `ChatSessionProvider` or
-     * `ChatSession` instead. Coupling navigation to the data source causes
-     * component remounts during active streams.
-     */
-    navigateToSession?: (sessionId: string) => void;
+/**
+ * Theme system type definitions
+ */
+interface Theme {
+    name: string;
+    colors: ThemeColors;
+    spacing: ThemeSpacing;
+    borderRadius: ThemeBorderRadius;
 }
-declare class HttpDataSource implements ChatDataSource {
-    private config;
-    private abortController;
-    private rpc;
-    constructor(config: HttpDataSourceConfig);
-    private getCSRFToken;
-    private createHeaders;
-    private createUploadHeaders;
-    private callRPC;
-    private boundCallRPC;
-    private boundUploadFile;
-    createSession(): Promise<Session$1>;
-    fetchSession(id: string): Promise<SessionState | null>;
-    listSessions(options?: {
-        limit?: number;
-        offset?: number;
-        includeArchived?: boolean;
-    }): Promise<SessionListResult$1>;
-    archiveSession(sessionId: string): Promise<Session$1>;
-    unarchiveSession(sessionId: string): Promise<Session$1>;
-    pinSession(sessionId: string): Promise<Session$1>;
-    unpinSession(sessionId: string): Promise<Session$1>;
-    deleteSession(sessionId: string): Promise<void>;
-    renameSession(sessionId: string, title: string): Promise<Session$1>;
-    regenerateSessionTitle(sessionId: string): Promise<Session$1>;
-    clearSessionHistory(sessionId: string): Promise<{
-        success: boolean;
-        deletedMessages: number;
-        deletedArtifacts: number;
-    }>;
-    compactSessionHistory(sessionId: string): Promise<{
-        success: boolean;
-        summary: string;
-        deletedMessages: number;
-        deletedArtifacts: number;
-    }>;
-    stopGeneration(sessionId: string): Promise<void>;
-    getStreamStatus(sessionId: string): Promise<StreamStatus | null>;
-    resumeStream(sessionId: string, runId: string, onChunk: (chunk: StreamChunk) => void, signal?: AbortSignal): Promise<void>;
-    sendMessage(sessionId: string, content: string, attachments?: Attachment$1[], signal?: AbortSignal, options?: SendMessageOptions): AsyncGenerator<StreamChunk>;
-    cancelStream(): void;
-    submitQuestionAnswers(sessionId: string, questionId: string, answers: QuestionAnswers): Promise<{
-        success: boolean;
-        error?: string;
-        data?: {
-            session: Session$1;
-            turns: ConversationTurn$1[];
-            pendingQuestion?: PendingQuestion$1 | null;
-        };
-    }>;
-    rejectPendingQuestion(sessionId: string): Promise<{
-        success: boolean;
-        error?: string;
-    }>;
-    fetchSessionArtifacts(sessionId: string, options?: {
-        limit?: number;
-        offset?: number;
-    }): Promise<{
-        artifacts: SessionArtifact[];
-        hasMore?: boolean;
-        nextOffset?: number;
-    }>;
-    uploadSessionArtifacts(sessionId: string, files: File[]): Promise<{
-        artifacts: SessionArtifact[];
-    }>;
-    renameSessionArtifact(artifactId: string, name: string, description?: string): Promise<SessionArtifact>;
-    deleteSessionArtifact(artifactId: string): Promise<void>;
-    /**
-     * @deprecated Pass `onSessionCreated` to `ChatSessionProvider` instead.
-     */
-    navigateToSession?(sessionId: string): void;
+interface ThemeColors {
+    background: string;
+    surface: string;
+    primary: string;
+    secondary: string;
+    text: string;
+    textMuted: string;
+    border: string;
+    error: string;
+    success: string;
+    warning: string;
+    userBubble: string;
+    assistantBubble: string;
+    userText: string;
+    assistantText: string;
+}
+interface ThemeSpacing {
+    xs: string;
+    sm: string;
+    md: string;
+    lg: string;
+    xl: string;
+}
+interface ThemeBorderRadius {
+    sm: string;
+    md: string;
+    lg: string;
+    full: string;
+}
+
+interface ThemeProviderProps {
+    theme?: Theme | 'light' | 'dark' | 'system';
+    children: ReactNode;
 }
 /**
- * Factory function to create HttpDataSource
+ * Theme provider component
+ * Wraps the application and provides theme context
  */
-declare function createHttpDataSource(config: HttpDataSourceConfig): ChatDataSource;
+declare function ThemeProvider({ theme, children }: ThemeProviderProps): react_jsx_runtime.JSX.Element;
+/**
+ * Hook to access current theme
+ */
+declare function useTheme(): Theme;
+
+/**
+ * Predefined theme configurations
+ */
+
+declare const lightTheme: Theme;
+declare const darkTheme: Theme;
+
+/**
+ * CSRF token management for API requests
+ */
+/**
+ * Get CSRF token from window object
+ * @returns CSRF token string
+ */
+declare function getCSRFToken(): string;
+/**
+ * Add CSRF token to request headers
+ * @param headers - Headers object to modify
+ * @returns Modified headers object
+ */
+declare function addCSRFHeader(headers: Headers): Headers;
+/**
+ * Create headers with CSRF token
+ * @param init - Optional initial headers
+ * @returns Headers object with CSRF token
+ */
+declare function createHeadersWithCSRF(init?: HeadersInit): Headers;
 
 /**
  * Internal types for the ChatMachine.
@@ -3972,4 +4244,4 @@ declare function isPermissionDeniedError(error: unknown): boolean;
  */
 declare function toErrorDisplay(error: unknown, fallbackTitle: string): RPCErrorDisplay;
 
-export { ATTACHMENT_ACCEPT_ATTRIBUTE, ActionButton, type ActionButtonIconProps, type ActionButtonLabelProps, type ActionButtonRootProps, type ActionButtonTooltipProps, type ActivityStep, ActivityTrace, type ActivityTraceProps, type AdminStore, _default$1 as Alert, AllChatsList, type AppConfig, _default as ArchiveBanner, ArchivedChatList, type Artifact$1 as Artifact, type ArtifactStore, type AsChildProps, AssistantMessage, type AssistantMessageActionsSlotProps, type AssistantMessageArtifactsSlotProps, type AssistantMessageAvatarSlotProps, type AssistantMessageChartsSlotProps, type AssistantMessageClassNames, type AssistantMessageCodeOutputsSlotProps, type AssistantMessageContentSlotProps, type AssistantMessageExplanationSlotProps, type AssistantMessageProps, type AssistantMessageSlots, type AssistantMessageSourcesSlotProps, type AssistantMessageTablesSlotProps, type AssistantTurn$1 as AssistantTurn, AssistantTurnView, type AssistantTurnViewProps, type Attachment$1 as Attachment, MemoizedAttachmentGrid as AttachmentGrid, AttachmentPreview, AttachmentUpload, Avatar, type AvatarFallbackProps, type AvatarImageProps, type AvatarRootProps, type BiChatConfig, BiChatLayout, type BiChatLayoutProps, type BichatRPC, Bubble, type BubbleContentProps, type BubbleFooterProps, type BubbleHeaderProps, type BubbleMetadataProps, type BubbleRootProps, type BubbleVariant, CHART_VISUAL, ChartCard, type ChartCardHost, type ChartData, type ChartSeries, type ChatDataSource, ChatHeader, type ChatInputStateValue, ChatMachine, type ChatMachineConfig, type ChatMessagingStateValue, ChatSession, type ChatSessionContextValue, ChatSessionProvider, type ChatSessionProviderProps, type ChatSessionStateValue, type Citation$1 as Citation, MemoizedCodeBlock as CodeBlock, type CodeOutput$1 as CodeOutput, CodeOutputsPanel, type ColumnMeta, type ColumnStats, type ColumnType, CompactionDoodle, ConfigProvider, ConfirmModal, type ConfirmModalProps, ConfirmationStep, type ConversationTurn$1 as ConversationTurn, type DataTableOptions, DateGroupHeader, DebugPanel, type DebugPanelProps, DefaultErrorContent, DownloadCard, MemoizedEditableText as EditableText, type EditableTextProps, type EditableTextRef, MemoizedEmptyState as EmptyState, type EmptyStateProps, ErrorBoundary, type FileValidationError, type FileVisual, type FormattedCell, HttpDataSource, type HttpDataSourceConfig, type ImageAttachment, type ImageLoadingStatus, ImageModal, InlineQuestionForm, InteractiveTableCard, type IotaContext, IotaContextProvider, ListItemSkeleton, MemoizedLoadingSpinner as LoadingSpinner, type LocaleContext, MemoizedMarkdownRenderer as MarkdownRenderer, MessageActions, MessageInput, type MessageInputProps, type MessageInputRef, MessageList, MessageRole, type MessageTransport, type PendingQuestion$1 as PendingQuestion, PermissionGuard, type PermissionGuardProps, type Question, type QuestionAnswerData, type QuestionAnswers, QuestionForm, type QuestionOption, QuestionStep, type QueuedMessage, type RPCErrorDisplay, RateLimiter, type RateLimiterConfig, type RenderTableData, type RenderTableExport, RetryActionArea, ScreenReaderAnnouncer, ScrollToBottomButton, MemoizedSearchInput as SearchInput, type SearchInputProps, type Session$1 as Session, type SessionArtifact, SessionArtifactList, SessionArtifactPreview, SessionArtifactsPanel, type SessionGroup, SessionItem, type SessionListResult$1 as SessionListResult, SessionSkeleton, type SessionStore, type SessionUser, type ShortcutConfig, Sidebar, type SidebarDrawerProps, type SidebarProps, MemoizedSkeleton as Skeleton, SkeletonAvatar, SkeletonCard, SkeletonGroup, type SkeletonGroupProps, type SkeletonProps, SkeletonText, SkipLink, Slot, type SlotProps, type SortState, SourcesPanel, type StreamChunk, StreamError, type StreamEvent, StreamingCursor, SystemMessage, TabbedChartGroup, type TabbedChartGroupProps, TabbedTableGroup, type TabbedTableGroupProps, type TableCardHost, TableExportButton, TableWithExport, type TenantContext, type Theme, type ThemeBorderRadius, type ThemeColors, ThemeProvider, type ThemeSpacing, Toast, type ToastAction, ToastContainer, type ToastItem, type ToastProps, type ToastType, type ToolCall$1 as ToolCall, TouchContextMenu, Turn, type TurnActionsProps, type TurnAssistantProps, TurnBubble, type TurnBubbleClassNames, type TurnBubbleProps, type TurnRootProps, type TurnTimestampProps, type TurnUserProps, MemoizedTypingIndicator as TypingIndicator, type TypingIndicatorProps, type UseAttachmentsOptions, type UseAttachmentsReturn, type UseAutoScrollOptions, type UseAutoScrollReturn, type UseDataTableReturn, type UseImageGalleryOptions, type UseImageGalleryReturn, type UseMarkdownCopyOptions, type UseMarkdownCopyReturn, type UseMessageActionsOptions, type UseMessageActionsReturn, type UseSidebarStateReturn, type UseToastReturn, MemoizedUserAvatar as UserAvatar, type UserAvatarProps, type UserContext, MemoizedUserFilter as UserFilter, UserMessage, type UserMessageActionsSlotProps, type UserMessageAttachmentsSlotProps, type UserMessageAvatarSlotProps, type UserMessageClassNames, type UserMessageContentSlotProps, type UserMessageProps, type UserMessageSlots, type UserTurn$1 as UserTurn, UserTurnView, type UserTurnViewProps, WelcomeContent, addCSRFHeader, backdropVariants, buttonVariants, convertToBase64, createDataUrl, createHeadersWithCSRF, createHttpDataSource, darkTheme, dropdownVariants, errorMessageVariants, fadeInUpVariants, fadeInVariants, floatingButtonVariants, formatFileSize, getCSRFToken, getFileVisual, getToolLabel, getValidChildren, groupSessionsByDate, groupSteps, hasPermission, isImageMimeType, isPermissionDeniedError, lightTheme, listItemVariants, messageContainerVariants, messageVariants, parseBichatStream, parseBichatStreamEvents, parseSSEStream, scaleFadeVariants, sessionItemVariants, staggerContainerVariants, toErrorDisplay, typingDotVariants, useActionButtonContext, useAttachments, useAutoScroll, useAvatarContext, useBubbleContext, useChatInput, useChatMessaging, useChatSession, useConfig, useDataTable, useFocusTrap, useImageGallery, useIotaContext, useKeyboardShortcuts, useLongPress, useMarkdownCopy, useMessageActions, useModalLock, useOptionalChatMessaging, useRequiredConfig, useScrollToBottom, useSidebarState, useStreaming, useTheme, useToast, useTranslation, useTurnContext, validateAttachmentFile, validateFileCount, validateImageFile, verbTransitionVariants };
+export { ATTACHMENT_ACCEPT_ATTRIBUTE, ActionButton, type ActionButtonIconProps, type ActionButtonLabelProps, type ActionButtonRootProps, type ActionButtonTooltipProps, type ActivityStep, ActivityTrace, type ActivityTraceProps, type AdminStore, _default$1 as Alert, AllChatsList, type AppConfig, _default as ArchiveBanner, ArchivedChatList, type Artifact$1 as Artifact, type ArtifactStore, type AsChildProps, AssistantMessage, type AssistantMessageActionsSlotProps, type AssistantMessageArtifactsSlotProps, type AssistantMessageAvatarSlotProps, type AssistantMessageChartsSlotProps, type AssistantMessageClassNames, type AssistantMessageCodeOutputsSlotProps, type AssistantMessageContentSlotProps, type AssistantMessageExplanationSlotProps, type AssistantMessageProps, type AssistantMessageSlots, type AssistantMessageSourcesSlotProps, type AssistantMessageTablesSlotProps, type AssistantTurn$1 as AssistantTurn, AssistantTurnView, type AssistantTurnViewProps, type Attachment$1 as Attachment, MemoizedAttachmentGrid as AttachmentGrid, AttachmentPreview, AttachmentUpload, Avatar, type AvatarFallbackProps, type AvatarImageProps, type AvatarRootProps, AvatarStack, type AvatarStackProps, type BiChatConfig, BiChatLayout, type BiChatLayoutProps, type BichatRPC, Bubble, type BubbleContentProps, type BubbleFooterProps, type BubbleHeaderProps, type BubbleMetadataProps, type BubbleRootProps, type BubbleVariant, CHART_VISUAL, ChartCard, type ChartCardHost, type ChartData, type ChartSeries, type ChatDataSource, ChatHeader, type ChatInputStateValue, ChatMachine, type ChatMachineConfig, type ChatMessagingStateValue, ChatSession, type ChatSessionContextValue, ChatSessionProvider, type ChatSessionProviderProps, type ChatSessionStateValue, type Citation$1 as Citation, MemoizedCodeBlock as CodeBlock, type CodeOutput$1 as CodeOutput, CodeOutputsPanel, type ColumnMeta, type ColumnStats, type ColumnType, CompactionDoodle, ConfigProvider, ConfirmModal, type ConfirmModalProps, ConfirmationStep, type ConversationTurn$1 as ConversationTurn, type DataTableOptions, DateGroupHeader, DebugPanel, type DebugPanelProps, DefaultErrorContent, DownloadCard, MemoizedEditableText as EditableText, type EditableTextProps, type EditableTextRef, MemoizedEmptyState as EmptyState, type EmptyStateProps, ErrorBoundary, type FileValidationError, type FileVisual, type FormattedCell, HttpDataSource, type HttpDataSourceConfig, type ImageAttachment, type ImageLoadingStatus, ImageModal, InlineQuestionForm, InteractiveTableCard, type IotaContext, IotaContextProvider, ListItemSkeleton, MemoizedLoadingSpinner as LoadingSpinner, type LocaleContext, MemoizedMarkdownRenderer as MarkdownRenderer, MessageActions, MessageInput, type MessageInputProps, type MessageInputRef, MessageList, MessageRole, type MessageTransport, type PendingQuestion$1 as PendingQuestion, PermissionGuard, type PermissionGuardProps, type Question, type QuestionAnswerData, type QuestionAnswers, QuestionForm, type QuestionOption, QuestionStep, type QueuedMessage, type RPCErrorDisplay, RateLimiter, type RateLimiterConfig, type RenderTableData, type RenderTableExport, RetryActionArea, ScreenReaderAnnouncer, ScrollToBottomButton, MemoizedSearchInput as SearchInput, type SearchInputProps, type Session$1 as Session, type SessionAccess$1 as SessionAccess, type SessionArtifact, SessionArtifactList, SessionArtifactPreview, SessionArtifactsPanel, type SessionGroup, SessionItem, type SessionListResult$1 as SessionListResult, type SessionMember$1 as SessionMember, SessionMembersModal, type SessionMembersModalProps, SessionSkeleton, type SessionStore, type SessionUser$1 as SessionUser, type ShortcutConfig, Sidebar, type SidebarDrawerProps, type SidebarProps, MemoizedSkeleton as Skeleton, SkeletonAvatar, SkeletonCard, SkeletonGroup, type SkeletonGroupProps, type SkeletonProps, SkeletonText, SkipLink, Slot, type SlotProps, type SortState, SourcesPanel, type StreamChunk, StreamError, type StreamEvent, StreamingCursor, SystemMessage, TabbedChartGroup, type TabbedChartGroupProps, TabbedTableGroup, type TabbedTableGroupProps, type TableCardHost, TableExportButton, TableWithExport, type TenantContext, type Theme, type ThemeBorderRadius, type ThemeColors, ThemeProvider, type ThemeSpacing, Toast, type ToastAction, ToastContainer, type ToastItem, type ToastProps, type ToastType, type ToolCall$1 as ToolCall, TouchContextMenu, Turn, type TurnActionsProps, type TurnAssistantProps, TurnBubble, type TurnBubbleClassNames, type TurnBubbleProps, type TurnRootProps, type TurnTimestampProps, type TurnUserProps, MemoizedTypingIndicator as TypingIndicator, type TypingIndicatorProps, type UseAttachmentsOptions, type UseAttachmentsReturn, type UseAutoScrollOptions, type UseAutoScrollReturn, type UseBichatRouterParams, type UseBichatRouterReturn, type UseDataTableReturn, type UseImageGalleryOptions, type UseImageGalleryReturn, type UseMarkdownCopyOptions, type UseMarkdownCopyReturn, type UseMessageActionsOptions, type UseMessageActionsReturn, type UseSidebarStateReturn, type UseToastReturn, MemoizedUserAvatar as UserAvatar, type UserAvatarProps, type UserContext, MemoizedUserFilter as UserFilter, UserMessage, type UserMessageActionsSlotProps, type UserMessageAttachmentsSlotProps, type UserMessageAvatarSlotProps, type UserMessageClassNames, type UserMessageContentSlotProps, type UserMessageProps, type UserMessageSlots, type UserTurn$1 as UserTurn, UserTurnView, type UserTurnViewProps, WelcomeContent, addCSRFHeader, backdropVariants, buttonVariants, convertToBase64, createDataUrl, createHeadersWithCSRF, createHttpDataSource, darkTheme, dropdownVariants, errorMessageVariants, fadeInUpVariants, fadeInVariants, floatingButtonVariants, formatFileSize, getCSRFToken, getFileVisual, getToolLabel, getValidChildren, groupSessionsByDate, groupSteps, hasPermission, isImageMimeType, isPermissionDeniedError, lightTheme, listItemVariants, messageContainerVariants, messageVariants, parseBichatStream, parseBichatStreamEvents, parseSSEStream, scaleFadeVariants, sessionItemVariants, staggerContainerVariants, toErrorDisplay, typingDotVariants, useActionButtonContext, useAttachments, useAutoScroll, useAvatarContext, useBichatRouter, useBubbleContext, useChatInput, useChatMessaging, useChatSession, useConfig, useDataTable, useFocusTrap, useHttpDataSourceConfigFromApplet, useImageGallery, useIotaContext, useKeyboardShortcuts, useLongPress, useMarkdownCopy, useMessageActions, useModalLock, useOptionalChatMessaging, useRequiredConfig, useScrollToBottom, useSidebarState, useStreaming, useTheme, useToast, useTranslation, useTurnContext, validateAttachmentFile, validateFileCount, validateImageFile, verbTransitionVariants };