@iblai/web-utils 1.6.8 → 1.6.9

package/dist/index.d.ts

@@ -1,17 +1,21 @@
 import * as _iblai_iblai_api from '@iblai/iblai-api';
 import { FreeUsageCount, StripeCustomerPortalRequest } from '@iblai/iblai-api';
+import * as _iblai_data_layer from '@iblai/data-layer';
 import { StripeContextResponse, AccessCheckResponse, UploadProfileImageResponse, RemoveProfileImageResponse, StorageService, TokenResponse, FileUploadURLResponse } from '@iblai/data-layer';
-import * as React from 'react';
-import React__default from 'react';
-import { PricingModalData as PricingModalData$1 } from '@web-utils/types/subscription';
+import * as React$1 from 'react';
+import React__default, { useEffect, RefObject, Dispatch, SetStateAction, ComponentType } from 'react';
+import { PricingModalData as PricingModalData$2 } from '@web-utils/types/subscription';
 import { OpUnitType } from 'dayjs';
 import duration from 'dayjs/plugin/duration';
 import { ChatStatus as ChatStatus$1 } from '@web-utils/features';
 import { Error402MessageData as Error402MessageData$1, Tenant as Tenant$3 } from '@web-utils/types';
 import * as _reduxjs_toolkit from '@reduxjs/toolkit';
 import { Reducer, Slice } from '@reduxjs/toolkit';
-import * as react_jsx_runtime from 'react/jsx-runtime';
 import { z } from 'zod';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { Slice as Slice$1, Reducer as Reducer$1 } from '@reduxjs/toolkit/react';
+import * as redux from 'redux';
+import * as mitt from 'mitt';
 
 interface Tenant$2 {
     key: string;
@@ -247,10 +251,10 @@ declare const useSubscriptionHandlerV2: (subscriptionFlow: SubscriptionFlowV2) =
 };
 
 declare const useExternalPricingPlan: ({ pricingModalData, userEmail, }: {
-    pricingModalData: PricingModalData$1;
+    pricingModalData: PricingModalData$2;
     userEmail: string;
 }) => {
-    pricingBoxIframeRef: React.RefObject<null>;
+    pricingBoxIframeRef: React$1.RefObject<null>;
 };
 
 declare const SUBSCRIPTION_V2_TRIGGERS: {
@@ -310,6 +314,28 @@ declare const SUBSCRIPTION_PACKAGES_V2: {
     PRO_PACKAGE: string;
 };
 
+type PricingTablePayload = {
+    pricing_table_id?: string;
+    publishable_key?: string;
+    client_reference_id?: string;
+};
+type Local402Data = {
+    error?: string;
+    message?: string;
+    pricing_table?: PricingTablePayload;
+};
+interface Use402ErrorCheckProps {
+    /**
+     * Called when an admin hits a 402. Hosts wire this to whatever navigation
+     * primitive they use (Next router push, history.pushState, custom event, etc.)
+     * to surface the billing tab.
+     */
+    navigateToAdminBilling: () => void;
+}
+declare const use402ErrorCheck: ({ navigateToAdminBilling, }: Use402ErrorCheckProps) => {
+    handle402Error: (messageData: Local402Data) => Promise<void>;
+};
+
 declare const useDayJs: () => {
     getTimeDifferenceBetweenTwoDates: (futureDate: string, pastDate: string, format?: OpUnitType) => number;
     getDayJSDurationObjFromSeconds: (seconds: number) => duration.Duration;
@@ -485,7 +511,7 @@ interface ArtifactVersion {
     created_by?: string;
     change_summary?: string;
 }
-interface Message {
+interface Message$1 {
     id: string;
     role: "user" | "assistant" | "system";
     content: string;
@@ -550,7 +576,7 @@ interface UseChatProps {
         id: string | null;
         content: string;
     }) => void;
-    onAddUserMessage?: (activeTab: AdvancedTab, message: Message) => void;
+    onAddUserMessage?: (activeTab: AdvancedTab, message: Message$1) => void;
     sendMessageToParentWebsite?: (payload: unknown) => void;
     on402Error?: (message: Error402MessageData$1) => void;
     onOAuthRequired?: (data: OAuthRequiredData) => void;
@@ -570,6 +596,7 @@ declare const useChat: ({ wsUrl, wsToken, flowConfig, sessionId, stopGenerationW
 
 declare const MENTOR_CHAT_DOCUMENTS_EXTENSIONS: string[];
 declare const ANONYMOUS_USERNAME = "anonymous";
+declare const DEFAULT_DISCLAIMER_CONTENT = "By accessing and using the [ibl.ai](http://ibl.ai/) MentorAI platform (\u201CPlatform\u201D), you agree to the following terms. The Platform provides AI-powered mentorship and educational support. You understand that AI responses may contain inaccuracies, and you are responsible for independently verifying any information before relying on it for academic, professional, or personal decisions. Do not input confidential, sensitive, or personally identifiable information of yourself or others.\nAll content, code, and data processed through the Platform remain the property of their respective owners. [ibl.ai](http://ibl.ai/) retains all rights to the Platform\u2019s underlying technology and intellectual property. You are granted a limited, non-exclusive, revocable license to use the Platform for personal or institutional learning purposes only.\nYour use must comply with applicable laws and institutional policies. Misuse\u2014including attempting to bypass security, copy source code, or use the service for unlawful activity\u2014may result in suspension or termination of access. Continued use constitutes acceptance of these terms.";
 declare const MAX_INITIAL_WEBSOCKET_CONNECTION_ATTEMPTS = 3;
 declare const LOCAL_STORAGE_KEYS: {
     CURRENT_TENANT: string;
@@ -579,6 +606,8 @@ declare const LOCAL_STORAGE_KEYS: {
     TOKEN_EXPIRY: string;
     USER_DATA: string;
     USER_TENANTS: string;
+    VISITING_TENANT: string;
+    SESSION_ID: string;
     EDX_TOKEN_KEY: string;
     DM_TOKEN_KEY: string;
     DM_TOKEN_EXPIRES: string;
@@ -613,7 +642,146 @@ declare const TOOLS: {
 declare const REQUIRED_ACTIONS_FOR_GROUPS: {
     readonly NOTIFICATIONS: "Ibl.Notifications/Notification/action";
 };
+declare const MENTOR_VISIBILITY_VALUES: {
+    ADMINISTRATORS: "viewable_by_tenant_admins";
+    STUDENTS: "viewable_by_tenant_students";
+    ANYONE: "viewable_by_anyone";
+};
+declare const MENTOR_VISIBILITY: ({
+    label: string;
+    value: "viewable_by_tenant_admins";
+} | {
+    label: string;
+    value: "viewable_by_tenant_students";
+} | {
+    label: string;
+    value: "viewable_by_anyone";
+})[];
+
+type ChatMode = "advanced" | "default";
+
+interface UseExternalPricingProps {
+    referenceId: string;
+    customerEmail: string;
+    publishableKey: string;
+    pricingId?: string;
+}
+interface PricingModalData$1 {
+    referenceId: string;
+    customerEmail: string;
+    publishableKey: string;
+    pricingTableId: string;
+}
+interface CreateStripeCustomerPortalRequest {
+    org: string;
+    userId: string;
+    requestBody: StripeCustomerPortalRequest;
+}
+/**
+ * Shape of the 402 Payment Required error response body.
+ * Note: Only `error` is required. Other fields may not be present
+ * in all error scenarios (e.g., generic API 402 vs WebSocket 402).
+ */
+interface Error402MessageData extends Partial<AccessCheckResponse> {
+    error: string;
+    message?: string;
+    details?: {
+        platform_key: string;
+        current_balance_usd: string;
+        required_usd: string;
+        deficit_usd: string;
+    };
+    pricing_table?: {
+        pricing_table_id: string;
+        pricing_table_js: string;
+        publishable_key?: string;
+        client_reference_id?: string;
+    };
+}
+
+declare const userDataSchema: z.ZodObject<{
+    user_display_name: z.ZodString;
+    user_email: z.ZodString;
+    user_fullname: z.ZodString;
+    user_id: z.ZodNumber;
+    user_nicename: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    user_display_name: string;
+    user_email: string;
+    user_fullname: string;
+    user_id: number;
+    user_nicename: string;
+}, {
+    user_display_name: string;
+    user_email: string;
+    user_fullname: string;
+    user_id: number;
+    user_nicename: string;
+}>;
+declare const tenantSchema: z.ZodObject<{
+    key: z.ZodString;
+    is_admin: z.ZodBoolean;
+    org: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    key: string;
+    is_admin: boolean;
+    org: string;
+}, {
+    key: string;
+    is_admin: boolean;
+    org: string;
+}>;
+declare const tenantKeySchema: z.ZodString;
+type TenantKeyMentorIdParams = {
+    tenantKey: string;
+    mentorId: string;
+};
+interface TopTrialBannerProps {
+    parentContainer: string;
+    bannerText?: string;
+    onUpgrade?: string;
+    loading?: boolean;
+    tooltipText?: string;
+}
+interface Prompt {
+    type: "static" | "human" | "ai";
+    icon?: string;
+    summary?: string;
+    content?: string;
+    proactive?: boolean;
+    hide?: boolean;
+    tag?: string;
+}
+interface Tenant {
+    key: string;
+    is_admin: boolean;
+    org: string;
+    name?: string;
+    platform_name: string;
+    is_advertising?: boolean;
+    is_enterprise?: boolean;
+    show_paywall?: boolean;
+}
 
+/**
+ * Reads the cached user_nicename from the LOCAL_STORAGE_KEYS.USER_DATA blob.
+ */
+declare const getUserName: () => string | null;
+/**
+ * Reads the cached user_email from the LOCAL_STORAGE_KEYS.USER_DATA blob.
+ */
+declare const getUserEmail: () => string | null;
+/**
+ * Whether Stripe-backed billing is active for the given tenant. The Stripe
+ * feature flag is a host-side config value; pass it in. Tenants opt in via
+ * `show_paywall` or by being the "main" platform tenant.
+ */
+declare function isStripeActivated(currentTenant: Tenant | null | undefined, stripeEnabled: boolean): boolean;
+/**
+ * Checks whether a file matches any of the accepted type specifiers.
+ * Supports MIME types (image/png), wildcard MIME (image/*), and extensions (.pdf).
+ */
+declare function isFileAccepted(file: File, acceptedTypes: string[]): boolean;
 declare const isJSON: (text: string) => boolean;
 declare const getInitials: (fullName: string) => string;
 declare const ALPHANUMERIC_32_REGEX: RegExp;
@@ -832,11 +1000,32 @@ declare const isWeb: () => boolean;
 declare const isNode: () => string | false;
 declare const isExpo: () => any;
 declare const isTauri: () => boolean;
-declare const getPlatform: () => "react-native" | "web" | "node" | "unknown";
+declare function isSafariBrowser(): boolean;
+declare const getPlatform: () => "web" | "react-native" | "node" | "unknown";
 declare const safeRequire: (moduleName: string) => any;
 declare const getNextNavigation: () => any;
 
-type ChatState = Record<AdvancedTab, Message[]>;
+/**
+ * Tauri API Cache
+ *
+ * localStorage-backed caching for API responses when running inside Tauri.
+ * In offline mode, cached responses are returned instead of making network requests.
+ */
+declare function isTauriOfflineMode(): boolean;
+declare function getCachedApiResponse<T>(endpoint: string, params?: Record<string, unknown>): T | null;
+declare function setCachedApiResponse<T>(endpoint: string, data: T, params?: Record<string, unknown>, ttlMs?: number): void;
+declare function clearApiCache(): void;
+declare function fetchWithCache<T>(endpoint: string, fetchFn: () => Promise<T>, params?: Record<string, unknown>, ttlMs?: number): Promise<T>;
+declare const CacheKeys: {
+    readonly mentorSettings: (org: string, mentor: string, userId: string) => string;
+    readonly mentorPublicSettings: (org: string, mentor: string) => string;
+    readonly tenantMetadata: (org: string) => string;
+    readonly userTenants: (userId: string) => string;
+    readonly sessionChats: (sessionId: string) => string;
+};
+declare function preCacheMentorData(org: string, mentorId: string, userId: string, fetchMentorSettings: () => Promise<unknown>, fetchTenantMetadata: () => Promise<unknown>): Promise<void>;
+
+type ChatState = Record<AdvancedTab, Message$1[]>;
 type SessionIds = Record<AdvancedTab, string>;
 type StreamingMessage = {
     id: string;
@@ -958,7 +1147,7 @@ declare const selectTokenEnabled: (state: {
 }) => boolean;
 declare const selectActiveChatMessages: (state: {
     chatSliceShared: ChatSliceState;
-}) => Message[];
+}) => Message$1[];
 declare const selectNumberOfActiveChatMessages: (state: {
     chatSliceShared: ChatSliceState;
 }) => number;
@@ -1071,6 +1260,9 @@ declare const updateFileMetadata: _reduxjs_toolkit.ActionCreatorWithoutPayload<`
 declare const updateFileRetryCount: _reduxjs_toolkit.ActionCreatorWithoutPayload<`${string}/${string}`> | _reduxjs_toolkit.ActionCreatorWithPayload<any, `${string}/${string}`> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, never> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, any> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, never> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, any>;
 declare const updateFileUrlFromWebSocket: _reduxjs_toolkit.ActionCreatorWithoutPayload<`${string}/${string}`> | _reduxjs_toolkit.ActionCreatorWithPayload<any, `${string}/${string}`> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, never> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, any> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, never> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, any>;
 declare const filesReducer: Reducer<FilesState>;
+declare const selectAttachedFiles: (state: {
+    files: FilesState;
+}) => AttachedFile[];
 
 /**
  * Combines multiple CSV data objects by merging rows based on a common column.
@@ -1125,112 +1317,107 @@ declare const setAccessCheckResponse: _reduxjs_toolkit.ActionCreatorWithoutPaylo
 declare const showMonetizationCheckoutModal: _reduxjs_toolkit.ActionCreatorWithoutPayload<`${string}/${string}`> | _reduxjs_toolkit.ActionCreatorWithPayload<any, `${string}/${string}`> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, never> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, any> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, never> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, any>;
 declare const setAdvancedDisplayMonetizationCheckoutModal: _reduxjs_toolkit.ActionCreatorWithoutPayload<`${string}/${string}`> | _reduxjs_toolkit.ActionCreatorWithPayload<any, `${string}/${string}`> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, never> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, any> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, never> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, any>;
 
-type ChatMode = "advanced" | "default";
+type RbacPermissions = {
+    mentors: Record<string, unknown>;
+    mentor: Record<string, unknown>;
+};
+interface RbacState {
+    rbacPermissions: RbacPermissions | Record<string, never>;
+}
+declare const updateRbacPermissions: _reduxjs_toolkit.ActionCreatorWithPayload<RbacPermissions | Record<string, never>, "rbac/updateRbacPermissions">;
+declare const rbacReducer: Reducer<RbacState>;
+declare const selectRbacPermissions: (state: {
+    rbac: RbacState;
+}) => RbacPermissions | Record<string, never>;
 
-interface UseExternalPricingProps {
-    referenceId: string;
-    customerEmail: string;
-    publishableKey: string;
-    pricingId?: string;
+interface ChatInputState {
+    textareaInput: string;
 }
+declare const chatInputSlice: Slice$1<ChatInputState>;
+declare const chatInputSliceSelectors: {
+    selectTextareaInput: (state: {
+        chatInput: ChatInputState;
+    }) => string;
+};
+declare const chatInputSliceActions: _reduxjs_toolkit.CaseReducerActions<_reduxjs_toolkit.SliceCaseReducers<ChatInputState>, string>;
+declare const chatInputSliceReducer: Reducer$1<ChatInputState>;
+
+interface Message {
+    role: "user" | "assistant";
+    content: string;
+    replyTo?: unknown;
+}
+interface HostChatState {
+    messages: Message[];
+    enableChatActionsPopup: boolean;
+}
+declare const hostChatSlice: Slice<HostChatState>;
+declare const addMessage: _reduxjs_toolkit.ActionCreatorWithoutPayload<`${string}/${string}`> | _reduxjs_toolkit.ActionCreatorWithPayload<any, `${string}/${string}`> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, never> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, any> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, never> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, any>;
+declare const clearMessages: _reduxjs_toolkit.ActionCreatorWithoutPayload<`${string}/${string}`> | _reduxjs_toolkit.ActionCreatorWithPayload<any, `${string}/${string}`> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, never> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, any> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, never> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, any>;
+declare const enableChatActionsPopup: _reduxjs_toolkit.ActionCreatorWithoutPayload<`${string}/${string}`> | _reduxjs_toolkit.ActionCreatorWithPayload<any, `${string}/${string}`> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, never> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, any> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, never> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, any>;
+declare const hostChatReducer: redux.Reducer<HostChatState>;
+declare const selectEnableChatActionsPopup: (state: {
+    chat: HostChatState;
+}) => boolean;
+
 interface PricingModalData {
     referenceId: string;
     customerEmail: string;
     publishableKey: string;
     pricingTableId: string;
 }
-interface CreateStripeCustomerPortalRequest {
-    org: string;
-    userId: string;
-    requestBody: StripeCustomerPortalRequest;
+interface FreeTrialUsageOptions {
+    count: number;
+    limitReached: boolean;
+    message: string;
 }
-/**
- * Shape of the 402 Payment Required error response body.
- * Note: Only `error` is required. Other fields may not be present
- * in all error scenarios (e.g., generic API 402 vs WebSocket 402).
- */
-interface Error402MessageData extends Partial<AccessCheckResponse> {
-    error: string;
-    message?: string;
-    details?: {
-        platform_key: string;
-        current_balance_usd: string;
-        required_usd: string;
-        deficit_usd: string;
-    };
-    pricing_table?: {
-        pricing_table_id: string;
-        pricing_table_js: string;
-        publishable_key?: string;
-        client_reference_id?: string;
-    };
+interface SubscriptionStatus {
+    creditExhausted: boolean;
+    userCapability?: string;
+    callToAction?: string;
+}
+interface SubscriptionState {
+    openPricingModal: boolean;
+    openAppleRestrictionModal: boolean;
+    freeTrialUsageOptions: FreeTrialUsageOptions;
+    pricingModalData: PricingModalData;
+    subscriptionStatus: SubscriptionStatus;
+    error402Detected: string;
 }
+declare const subscriptionSlice: Slice<SubscriptionState>;
+declare const setOpenPricingModal: _reduxjs_toolkit.ActionCreatorWithoutPayload<`${string}/${string}`> | _reduxjs_toolkit.ActionCreatorWithPayload<any, `${string}/${string}`> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, never> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, any> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, never> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, any>;
+declare const setOpenAppleRestrictionModal: _reduxjs_toolkit.ActionCreatorWithoutPayload<`${string}/${string}`> | _reduxjs_toolkit.ActionCreatorWithPayload<any, `${string}/${string}`> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, never> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, any> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, never> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, any>;
+declare const setFreeTrialUsageOptions: _reduxjs_toolkit.ActionCreatorWithoutPayload<`${string}/${string}`> | _reduxjs_toolkit.ActionCreatorWithPayload<any, `${string}/${string}`> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, never> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, any> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, never> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, any>;
+declare const setPricingModalData: _reduxjs_toolkit.ActionCreatorWithoutPayload<`${string}/${string}`> | _reduxjs_toolkit.ActionCreatorWithPayload<any, `${string}/${string}`> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, never> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, any> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, never> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, any>;
+declare const setSubscriptionStatus: _reduxjs_toolkit.ActionCreatorWithoutPayload<`${string}/${string}`> | _reduxjs_toolkit.ActionCreatorWithPayload<any, `${string}/${string}`> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, never> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, any> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, never> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, any>;
+declare const setError402Detected: _reduxjs_toolkit.ActionCreatorWithoutPayload<`${string}/${string}`> | _reduxjs_toolkit.ActionCreatorWithPayload<any, `${string}/${string}`> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, never> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, any> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, never> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, any>;
+declare const subscriptionReducer: redux.Reducer<SubscriptionState>;
 
-declare const userDataSchema: z.ZodObject<{
-    user_display_name: z.ZodString;
-    user_email: z.ZodString;
-    user_fullname: z.ZodString;
-    user_id: z.ZodNumber;
-    user_nicename: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    user_display_name: string;
-    user_email: string;
-    user_fullname: string;
-    user_id: number;
-    user_nicename: string;
-}, {
-    user_display_name: string;
-    user_email: string;
-    user_fullname: string;
-    user_id: number;
-    user_nicename: string;
-}>;
-declare const tenantSchema: z.ZodObject<{
-    key: z.ZodString;
-    is_admin: z.ZodBoolean;
-    org: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    key: string;
-    is_admin: boolean;
-    org: string;
-}, {
-    key: string;
-    is_admin: boolean;
-    org: string;
-}>;
-declare const tenantKeySchema: z.ZodString;
-type TenantKeyMentorIdParams = {
-    tenantKey: string;
-    mentorId: string;
-};
-interface TopTrialBannerProps {
-    parentContainer: string;
+/**
+ * Structural shape of TopBannerProps. Mirrors `@iblai/web-containers`
+ * `<TopBanner>` so this slice can be consumed without taking a circular
+ * dependency on the web-containers package.
+ */
+interface TopBannerOptions {
+    parentContainerSelector: string;
     bannerText?: string;
-    onUpgrade?: string;
     loading?: boolean;
     tooltipText?: string;
+    buttonHandler?: () => void;
+    buttonLabel?: string;
+    onLoad?: (bannerRef: HTMLDivElement) => void;
+    onClose?: () => void;
+    enabled: boolean;
+    onUpgrade?: string;
 }
-interface Prompt {
-    type: "static" | "human" | "ai";
-    icon?: string;
-    summary?: string;
-    content?: string;
-    proactive?: boolean;
-    hide?: boolean;
-    tag?: string;
-}
-interface Tenant {
-    key: string;
-    is_admin: boolean;
-    org: string;
-    name?: string;
-    platform_name: string;
-    is_advertising?: boolean;
-    is_enterprise?: boolean;
-    show_paywall?: boolean;
+interface TopBannerState {
+    topBannerOptions: TopBannerOptions;
 }
+declare const topBannerSlice: Slice<TopBannerState>;
+declare const setTopBannerOptions: _reduxjs_toolkit.ActionCreatorWithoutPayload<`${string}/${string}`> | _reduxjs_toolkit.ActionCreatorWithPayload<any, `${string}/${string}`> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, never> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, never, any> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, never> | _reduxjs_toolkit.ActionCreatorWithPreparedPayload<any[], any, `${string}/${string}`, any, any>;
+declare const topBannerReducer: redux.Reducer<TopBannerState>;
 
-type Props$5 = {
+type Props$7 = {
     mode?: ChatMode;
     tenantKey: string;
     mentorId: string;
@@ -1252,8 +1439,8 @@ type Props$5 = {
     onOfflineWithoutLocalLLM?: () => void;
     isPublicRoute?: boolean;
 };
-declare function useAdvancedChat({ tenantKey, mentorId, username, token, wsUrl, stopGenerationWsUrl, redirectToAuthSpa, errorHandler, sendMessageToParentWebsite, isPreviewMode, mentorShareableToken, on402Error, cachedSessionId, onStartNewChat, onOAuthRequired, onOAuthResolved, isOffline, onOfflineWithoutLocalLLM, isPublicRoute, }: Props$5): {
-    messages: Message[];
+declare function useAdvancedChat({ tenantKey, mentorId, username, token, wsUrl, stopGenerationWsUrl, redirectToAuthSpa, errorHandler, sendMessageToParentWebsite, isPreviewMode, mentorShareableToken, on402Error, cachedSessionId, onStartNewChat, onOAuthRequired, onOAuthResolved, isOffline, onOfflineWithoutLocalLLM, isPublicRoute, }: Props$7): {
+    messages: Message$1[];
     isStreaming: boolean;
     status: ChatStatus;
     isPending: boolean;
@@ -1267,7 +1454,7 @@ declare function useAdvancedChat({ tenantKey, mentorId, username, token, wsUrl,
     enabledGuidedPrompts: boolean;
     sendMessage: (tab: AdvancedTab, text: string, options?: SendMessageOptions) => Promise<void>;
     stopGenerating: () => void;
-    setMessage: (message: Message) => void;
+    setMessage: (message: Message$1) => void;
     changeTab: (tab: AdvancedTab) => Promise<void>;
     sessionId: string;
     startNewChat: () => Promise<void>;
@@ -1276,20 +1463,20 @@ declare function useAdvancedChat({ tenantKey, mentorId, username, token, wsUrl,
     isConnected: React__default.MutableRefObject<boolean>;
     messageQueue: React__default.MutableRefObject<any[]>;
     sessionIds: SessionIds;
-    enableSafetyDisclaimer: boolean;
+    enableSafetyDisclaimer: any;
     resetConnection: () => void;
     isLoadingChats: boolean;
     refetchChats: () => Promise<void>;
 };
 
-type Props$4 = {
+type Props$6 = {
     tenantKey: string;
     mentorId: string;
     username: string;
     errorHandler?: (message: string, error?: any) => void;
     isPublicRoute?: boolean;
 };
-declare function useMentorTools({ tenantKey, mentorId, username, errorHandler, isPublicRoute, }: Props$4): {
+declare function useMentorTools({ tenantKey, mentorId, username, errorHandler, isPublicRoute, }: Props$6): {
     tools: any;
     activeTools: string[];
     updateSessionTools: (tool: string) => Promise<void>;
@@ -1460,31 +1647,51 @@ interface TenantMetadata {
 }
 declare const METADATAS: TenantMetadata$1[];
 
-type Props$3 = {
+type Props$5 = {
     mentorId: string;
     tenantKey: string;
-    username: string;
+    /**
+     * Whether the caller is on a public route (e.g. a shareable token link).
+     * Skips the private mentor-settings query when true.
+     */
     isPublicRoute?: boolean;
+    /**
+     * Key of the platform's "main" tenant. When provided, isCommunityMentor
+     * resolves to true only if the mentor lives under this tenant. Without it,
+     * isCommunityMentor is always false.
+     */
+    mainTenantKey?: string;
 };
-type MentorSettingsData = {
-    profileImage?: string | null;
-    greetingMethod?: string | null;
-    proactiveResponse?: string | null;
-    llmProvider?: string | null;
-    llmName?: string | null;
-    mentorUniqueId?: string | null;
-    mentorVisibility?: string | null | any;
-    mentorName?: string | null;
-    enableGuidedPrompts?: boolean | null;
-    mentorSlug?: string | null;
-    safetyDisclaimer: boolean;
-    mentorTools?: any[] | null;
-    allowAnonymous?: boolean | null;
-};
-type UseMentorSettingsReturn = {
-    data: MentorSettingsData;
+declare function useMentorSettings({ mentorId, tenantKey, isPublicRoute, mainTenantKey, }: Props$5): {
+    isLoading: boolean;
+    data: {
+        profileImage: string | null | undefined;
+        greetingMethod: string | undefined;
+        proactiveResponse: string | undefined;
+        llmProvider: string;
+        llmName: string | undefined;
+        mentorUniqueId: string | undefined;
+        mentorName: string | undefined;
+        enableGuidedPrompts: boolean | undefined;
+        mentorSlug: string | undefined;
+        safetyDisclaimer: any;
+        isCommunityMentor: boolean;
+        disclaimer: string | undefined;
+        mentorVisibility: _iblai_iblai_api.NullEnum | null | undefined;
+        allowAnonymous: boolean | undefined;
+        showAttachment: boolean | undefined;
+        showVoiceCall: boolean | undefined;
+        showVoiceRecord: boolean | undefined;
+        embedShowAttachment: boolean | undefined;
+        embedShowVoiceCall: boolean | undefined;
+        embedShowVoiceRecord: boolean | undefined;
+        llmConfig: any;
+        mentorDbId: number | undefined;
+        starterPrompts: string | undefined;
+        memoryEnabled: boolean;
+        mentorTools: any;
+    };
 };
-declare function useMentorSettings({ mentorId, tenantKey, username, isPublicRoute, }: Props$3): UseMentorSettingsReturn;
 
 interface UseStripeUpgradeArgs {
     redirectUrl: string;
@@ -1500,6 +1707,249 @@ declare const useStripeUpgrade: ({ redirectUrl, sourcePlatformKey, mainPlatformK
     handleUpgrade: (redirectPlan?: StripeUpgradePlan) => Promise<void>;
 };
 
+declare const useIsomorphicLayoutEffect: typeof useEffect;
+
+declare function useEventCallback<Args extends unknown[], R>(fn: (...args: Args) => R): (...args: Args) => R;
+declare function useEventCallback<Args extends unknown[], R>(fn: ((...args: Args) => R) | undefined): ((...args: Args) => R) | undefined;
+
+declare function useEventListener<K extends keyof MediaQueryListEventMap>(eventName: K, handler: (event: MediaQueryListEventMap[K]) => void, element: RefObject<MediaQueryList>, options?: boolean | AddEventListenerOptions): void;
+declare function useEventListener<K extends keyof WindowEventMap>(eventName: K, handler: (event: WindowEventMap[K]) => void, element?: undefined, options?: boolean | AddEventListenerOptions): void;
+declare function useEventListener<K extends keyof HTMLElementEventMap & keyof SVGElementEventMap, T extends Element = K extends keyof HTMLElementEventMap ? HTMLDivElement : SVGElement>(eventName: K, handler: ((event: HTMLElementEventMap[K]) => void) | ((event: SVGElementEventMap[K]) => void), element: RefObject<T>, options?: boolean | AddEventListenerOptions): void;
+declare function useEventListener<K extends keyof DocumentEventMap>(eventName: K, handler: (event: DocumentEventMap[K]) => void, element: RefObject<Document>, options?: boolean | AddEventListenerOptions): void;
+
+declare global {
+    interface WindowEventMap {
+        "local-storage": CustomEvent;
+    }
+}
+type UseLocalStorageOptions<T> = {
+    serializer?: (value: T) => string;
+    deserializer?: (value: string) => T;
+    initializeWithValue?: boolean;
+};
+declare function useLocalStorage<T>(key: string, initialValue: T | (() => T), options?: UseLocalStorageOptions<T>): [T, Dispatch<SetStateAction<T>>, () => void];
+
+declare function useUserData(): {
+    user_display_name: string;
+    user_email: string;
+    user_fullname: string;
+    user_id: number;
+    user_nicename: string;
+} | null;
+declare function useUsername(): string | null;
+declare function useVisitingTenant(): {
+    visitingTenant: Tenant | undefined;
+    saveVisitingTenant: React$1.Dispatch<React$1.SetStateAction<Tenant | undefined>>;
+    removeVisitingTenant: () => void;
+};
+declare function useUserTenants(): {
+    userTenants: Tenant[];
+    saveUserTenants: React$1.Dispatch<React$1.SetStateAction<Tenant[]>>;
+};
+declare function useCurrentTenant(): {
+    currentTenant: Tenant | null;
+    saveCurrentTenant: React$1.Dispatch<React$1.SetStateAction<Tenant | null>>;
+};
+declare function useIsAdmin(): boolean;
+
+declare function useDmToken(): string;
+declare function useAxdToken(): string;
+
+declare function useAccessingPublicRoute(): boolean;
+
+declare function useEmbedMode(): boolean;
+
+interface FileUploadCapabilities$1 {
+    supportsFileUpload: boolean;
+    allSupportedTypes: string[];
+    maxFileSizeMB: number;
+    maxFilesPerMessage: number;
+}
+interface UseChatFileUploadProps {
+    org: string;
+    userId: string;
+    errorHandler?: (error: string) => void;
+    capabilities?: FileUploadCapabilities$1;
+}
+declare function useChatFileUpload({ org, userId, errorHandler, capabilities, }: UseChatFileUploadProps): {
+    uploadFiles: (files: File[]) => Promise<void>;
+    retryUpload: (fileId: string) => Promise<void>;
+};
+
+interface UseModelFileUploadCapabilitiesProps {
+    mentorId: string;
+    tenantKey: string;
+    isPublicRoute?: boolean;
+}
+interface FileUploadCapabilities {
+    supportsFileUpload: boolean;
+    supportsImages: boolean;
+    supportsDocuments: boolean;
+    supportedImageTypes: string[];
+    supportedDocumentTypes: string[];
+    allSupportedTypes: string[];
+    maxFileSizeMB: number;
+    maxFilesPerMessage: number;
+    supportsFileUrls: boolean;
+}
+/**
+ * Hook to determine file upload capabilities based on the LLM config.
+ */
+declare function useModelFileUploadCapabilities({ mentorId, tenantKey, isPublicRoute, }: UseModelFileUploadCapabilitiesProps): FileUploadCapabilities;
+
+interface UseFileDragDropOptions {
+    org: string;
+    userId: string;
+    mentorId: string;
+    tenantKey: string;
+    isPublicRoute?: boolean;
+}
+declare function useFileDragDrop({ org, userId, mentorId, tenantKey, isPublicRoute, }: UseFileDragDropOptions): {
+    isDraggingFile: boolean;
+    handleDragOver: (e: React__default.DragEvent) => void;
+    handleDragLeave: (e: React__default.DragEvent) => void;
+    handleDrop: (e: React__default.DragEvent) => Promise<void>;
+};
+
+/**
+ * Persists a map of mentorId -> sessionId in localStorage so a chat session
+ * can be restored across reloads on a per-mentor basis.
+ *
+ * Returns a tuple shaped like useLocalStorage:
+ * `[cachedSessionId, saveCachedSessionId]`.
+ */
+declare function useCachedSessionId(): [Record<string, string>, React$1.Dispatch<React$1.SetStateAction<Record<string, string>>>, () => void];
+
+interface UseUserAgreementProps {
+    mentorId: string;
+    tenantKey: string;
+}
+declare function useUserAgreement({ mentorId, tenantKey, }: UseUserAgreementProps): {
+    showDisclaimerModal: boolean;
+    setShowDisclaimerModal: React$1.Dispatch<React$1.SetStateAction<boolean>>;
+    isAgreeing: boolean;
+    pendingSubmitContent: string;
+    userAgreement: _iblai_data_layer.Disclaimer | {
+        readonly content: "By accessing and using the [ibl.ai](http://ibl.ai/) MentorAI platform (“Platform”), you agree to the following terms. The Platform provides AI-powered mentorship and educational support. You understand that AI responses may contain inaccuracies, and you are responsible for independently verifying any information before relying on it for academic, professional, or personal decisions. Do not input confidential, sensitive, or personally identifiable information of yourself or others.\nAll content, code, and data processed through the Platform remain the property of their respective owners. [ibl.ai](http://ibl.ai/) retains all rights to the Platform’s underlying technology and intellectual property. You are granted a limited, non-exclusive, revocable license to use the Platform for personal or institutional learning purposes only.\nYour use must comply with applicable laws and institutional policies. Misuse—including attempting to bypass security, copy source code, or use the service for unlawful activity—may result in suspension or termination of access. Continued use constitutes acceptance of these terms.";
+        readonly active: false;
+    };
+    hasUserAgreement: boolean;
+    hasUserAgreedToDisclaimer: boolean;
+    isDisclaimersLoading: boolean;
+    handleDisclaimerAgree: () => Promise<void>;
+    checkAgreementAndExecute: (content: string, executeCallback: (content: string) => void) => void;
+    executePendingSubmit: (executeCallback: (content: string) => void) => void;
+};
+
+interface UseShowVoiceRecorderProps {
+    mentorId: string;
+    tenantKey: string;
+    isPublicRoute?: boolean;
+}
+declare function useShowVoiceRecorder({ mentorId, tenantKey, isPublicRoute, }: UseShowVoiceRecorderProps): boolean;
+
+interface UseShowVoiceCallProps {
+    mentorId: string;
+    tenantKey: string;
+    isPublicRoute?: boolean;
+}
+declare function useShowVoiceCall({ mentorId, tenantKey, isPublicRoute, }: UseShowVoiceCallProps): boolean;
+
+interface UseShowAttachmentProps {
+    mentorId: string;
+    tenantKey: string;
+    isPublicRoute?: boolean;
+}
+declare function useShowAttachment({ mentorId, tenantKey, isPublicRoute, }: UseShowAttachmentProps): boolean;
+
+type Props$4 = {
+    sessionId: string;
+    username: string;
+    tenantKey: string;
+    mentorId: string;
+    mentorUniqueId: string;
+    token: string;
+    wsUrl: string;
+    isPublicRoute?: boolean;
+    isNewSession?: boolean;
+};
+declare function useWelcome({ sessionId, username, tenantKey, mentorId, mentorUniqueId, token, wsUrl, isPublicRoute, isNewSession, }: Props$4): {
+    welcomeMessage: string;
+    handleSendProactivePrompt: () => void;
+};
+
+/**
+ * Tracks container width / viewport and returns a small screen-size bag.
+ * If a ref is passed, the hook observes that element via ResizeObserver
+ * and reacts to its width changes; otherwise it tracks window width.
+ */
+declare const useResponsive: (containerRef?: React.RefObject<HTMLElement>) => {
+    isMobile: boolean;
+    isTablet: boolean;
+    isLaptop: boolean;
+    isDesktop: boolean;
+    screenSize: "sm" | "md" | "lg" | "xl";
+    containerWidth: number;
+};
+
+declare function useTimer(): {
+    startTime: Date | null;
+    time: number;
+    isRunning: boolean;
+    start: () => void;
+    stop: () => void;
+};
+
+interface Props$3 {
+    sendMessage: (message: string) => void;
+    tenantKey: string;
+}
+declare function useVoiceChat({ sendMessage, tenantKey }: Props$3): {
+    handleMicrophoneBtnClick: () => Promise<void>;
+    recording: boolean;
+    processing: boolean;
+    time: number;
+};
+
+interface FreeTrialDialogProps {
+    isOpen: boolean;
+    onClose: () => void;
+}
+interface UseShowFreeTrialDialogReturn {
+    FreeTrialDialog: ComponentType<FreeTrialDialogProps> | null;
+    closeModal: () => void;
+    isModalOpen: boolean;
+    /**
+     * Run a callback, optionally gated by the trial check. The second
+     * `enforceTrialCheck` flag mirrors the mentor app's signature so call
+     * sites that pass `false` (i.e. opt-out of gating) typecheck against
+     * the stub. The stub ignores the flag and always runs the callback.
+     */
+    executeWithTrialCheck: (callback: () => void, enforceTrialCheck?: boolean) => void;
+}
+/**
+ * Stub implementation of the mentor app's free-trial gate.
+ *
+ * Always reports the gate as inactive (`isModalOpen: false`,
+ * `FreeTrialDialog: null`) and executes any guarded callback immediately.
+ * Mirrors the call-site shape of the mentor app's
+ * `useShowFreeTrialDialog` so the reusable Chat can render without
+ * pulling in the entire subscription / Apple-restriction flow.
+ *
+ * Host apps that want a real gate should replace this hook with their
+ * own implementation that wires up the subscription flow they use.
+ */
+declare function useShowFreeTrialDialog(): UseShowFreeTrialDialogReturn;
+
+/**
+ * Returns OS-derived flags. Currently only detects whether the host is an
+ * Apple device (macOS or iOS) via Tauri's plugin-os. In plain browsers
+ * (no Tauri runtime) `isAppleDevice` is always false.
+ */
+declare const useOS: () => {
+    isAppleDevice: boolean;
+};
+
 /**
  * Sync authentication state to cookies (web only)
  * Should be called on login, logout, and tenant switch
@@ -1518,7 +1968,7 @@ declare function clearCurrentTenantCookie(): void;
  * On React Native, this is a no-op
  */
 declare function clearAuthCookies(): void;
-declare function getUserName(storageService: StorageService): Promise<any>;
+declare function getStoredUserName(storageService: StorageService): Promise<any>;
 declare function useAuthProvider({ middleware, onAuthSuccess, onAuthFailure, redirectToAuthSpa, hasNonExpiredAuthToken, username, pathname, storageService, skipAuthCheck, token, enableStorageSync, }: Props$2): {
     isAuthenticating: boolean;
     userIsAccessingPublicRoute: boolean;
@@ -1575,7 +2025,7 @@ type Props$2 = {
  * 4. Handles redirects to auth SPA when needed
  * 5. Manages public route access state
  */
-declare function AuthProvider({ children, fallback, middleware, onAuthSuccess, onAuthFailure, redirectToAuthSpa, hasNonExpiredAuthToken, username, pathname, storageService, token, enableStorageSync, skip, }: Props$2): string | number | bigint | boolean | Iterable<React__default.ReactNode> | Promise<string | number | bigint | boolean | React__default.ReactPortal | React__default.ReactElement<unknown, string | React__default.JSXElementConstructor<any>> | Iterable<React__default.ReactNode> | null | undefined> | react_jsx_runtime.JSX.Element | null | undefined;
+declare function AuthProvider({ children, fallback, middleware, onAuthSuccess, onAuthFailure, redirectToAuthSpa, hasNonExpiredAuthToken, username, pathname, storageService, token, enableStorageSync, skip, }: Props$2): string | number | bigint | boolean | react_jsx_runtime.JSX.Element | Iterable<React__default.ReactNode> | Promise<string | number | bigint | boolean | React__default.ReactPortal | React__default.ReactElement<unknown, string | React__default.JSXElementConstructor<any>> | Iterable<React__default.ReactNode> | null | undefined> | null | undefined;
 
 /**
  * Props for the MentorProvider component
@@ -1608,7 +2058,7 @@ type Props$1 = {
  * 3. Manages redirection based on mentor availability
  * 4. Integrates with tenant context for access control
  */
-declare function MentorProvider({ children, fallback, onAuthSuccess, onAuthFailure, redirectToAuthSpa, redirectToMentor, onLoadMentorsPermissions, redirectToNoMentorsPage, redirectToCreateMentor, username, isAdmin, mainTenantKey, requestedMentorId, handleMentorNotFound, forceDetermineMentor, onComplete, skip, }: Props$1): string | number | bigint | boolean | Iterable<React__default.ReactNode> | Promise<string | number | bigint | boolean | React__default.ReactPortal | React__default.ReactElement<unknown, string | React__default.JSXElementConstructor<any>> | Iterable<React__default.ReactNode> | null | undefined> | react_jsx_runtime.JSX.Element | null | undefined;
+declare function MentorProvider({ children, fallback, onAuthSuccess, onAuthFailure, redirectToAuthSpa, redirectToMentor, onLoadMentorsPermissions, redirectToNoMentorsPage, redirectToCreateMentor, username, isAdmin, mainTenantKey, requestedMentorId, handleMentorNotFound, forceDetermineMentor, onComplete, skip, }: Props$1): string | number | bigint | boolean | react_jsx_runtime.JSX.Element | Iterable<React__default.ReactNode> | Promise<string | number | bigint | boolean | React__default.ReactPortal | React__default.ReactElement<unknown, string | React__default.JSXElementConstructor<any>> | Iterable<React__default.ReactNode> | null | undefined> | null | undefined;
 
 /**
  * Type definition for the tenant context
@@ -1672,7 +2122,98 @@ type Props = {
  * 4. Handles tenant-specific domain redirects
  * 5. Maintains tenant access state
  */
-declare function TenantProvider({ children, fallback, onAuthSuccess, onAuthFailure, currentTenant, requestedTenant, saveCurrentTenant, saveUserTenants, handleTenantSwitch, saveVisitingTenant, removeVisitingTenant, saveUserTokens, saveTenant, onAutoJoinUserToTenant, redirectToAuthSpa, username, isIframed, setUseMentorProvider, skip, onLoadPlatformPermissions, skipCustomDomainCheck, onTenantMismatch, }: Props): string | number | bigint | boolean | Iterable<React__default.ReactNode> | Promise<string | number | bigint | boolean | React__default.ReactPortal | React__default.ReactElement<unknown, string | React__default.JSXElementConstructor<any>> | Iterable<React__default.ReactNode> | null | undefined> | react_jsx_runtime.JSX.Element | null | undefined;
+declare function TenantProvider({ children, fallback, onAuthSuccess, onAuthFailure, currentTenant, requestedTenant, saveCurrentTenant, saveUserTenants, handleTenantSwitch, saveVisitingTenant, removeVisitingTenant, saveUserTokens, saveTenant, onAutoJoinUserToTenant, redirectToAuthSpa, username, isIframed, setUseMentorProvider, skip, onLoadPlatformPermissions, skipCustomDomainCheck, onTenantMismatch, }: Props): string | number | bigint | boolean | react_jsx_runtime.JSX.Element | Iterable<React__default.ReactNode> | Promise<string | number | bigint | boolean | React__default.ReactPortal | React__default.ReactElement<unknown, string | React__default.JSXElementConstructor<any>> | Iterable<React__default.ReactNode> | null | undefined> | null | undefined;
+
+/**
+ * Service Worker Registration Helper
+ *
+ * Handles registration, updates, and communication with the service worker.
+ */
+interface ServiceWorkerStatus {
+    isSupported: boolean;
+    isRegistered: boolean;
+    isOnline: boolean;
+    registration: ServiceWorkerRegistration | null;
+    updateAvailable: boolean;
+}
+type UpdateCallback = (registration: ServiceWorkerRegistration) => void;
+type StatusChangeCallback = (status: ServiceWorkerStatus) => void;
+/**
+ * Check if service workers are supported
+ */
+declare function isServiceWorkerSupported(): boolean;
+/**
+ * Get current service worker status
+ */
+declare function getServiceWorkerStatus(): ServiceWorkerStatus;
+/**
+ * Register the service worker.
+ * Defers registration until the page is fully loaded to avoid
+ * interfering with chunk loading — especially in WebKit/Safari where
+ * early SW registration can cause ChunkLoadError timeouts.
+ */
+declare function registerServiceWorker(basePath?: string): Promise<ServiceWorkerRegistration | null>;
+/**
+ * Unregister the service worker
+ */
+declare function unregisterServiceWorker(): Promise<boolean>;
+/**
+ * Skip waiting and activate new service worker immediately
+ */
+declare function skipWaiting(): void;
+/**
+ * Clear all caches
+ */
+declare function clearAllCaches(): void;
+/**
+ * Tell service worker we're running in Tauri
+ */
+declare function setTauriMode(isTauri: boolean): void;
+/**
+ * Tell service worker about offline status (from Tauri)
+ */
+declare function setOfflineStatus(isOffline: boolean): void;
+/**
+ * Request cache status from service worker
+ */
+declare function getCacheStatus(): Promise<Record<string, number> | null>;
+/**
+ * Subscribe to service worker updates
+ */
+declare function onUpdate(callback: UpdateCallback): () => void;
+/**
+ * Subscribe to status changes (online/offline, registration, updates)
+ */
+declare function onStatusChange(callback: StatusChangeCallback): () => void;
+/**
+ * Setup online/offline listeners
+ */
+declare function setupNetworkListeners(): () => void;
+/**
+ * Initialize service worker and network listeners
+ * Call this once when app loads
+ */
+declare function initServiceWorker(basePath?: string): Promise<ServiceWorkerStatus>;
+
+interface ServiceWorkerContextValue {
+    status: ServiceWorkerStatus;
+    applyUpdate: () => void;
+    clearCache: () => void;
+    refreshCacheStatus: () => Promise<Record<string, number> | null>;
+    checkNetworkNow: () => Promise<boolean>;
+}
+declare function useServiceWorker(): ServiceWorkerContextValue;
+interface ServiceWorkerProviderProps {
+    children: React.ReactNode;
+    /**
+     * Base path used when registering the service worker. The SW is fetched
+     * from `${basePath}/sw.js` and scoped to `basePath || '/'`. Pass the
+     * host app's bundler-resolved base path (e.g. Next.js's
+     * `process.env.NEXT_PUBLIC_BASE_PATH`). Defaults to '' (root).
+     */
+    basePath?: string;
+}
+declare function ServiceWorkerProvider({ children, basePath, }: ServiceWorkerProviderProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Chat area size constants
@@ -1742,6 +2283,13 @@ declare function createMultipleFileReferences(files: File[], sessionId: string,
  */
 declare function validateFile(file: File, maxSizeBytes?: number, allowedTypes?: string[]): string | null;
 
+declare const eventBus: mitt.Emitter<Record<mitt.EventType, unknown>>;
+declare enum RemoteEvents {
+    newChat = "MENTOR:NEW_CHAT",
+    stopChatGenerating = "MENTOR:STOP_CHAT_GENERATING",
+    sendChatMessage = "MENTOR:SEND_CHAT_MESSAGE"
+}
+
 type WithFormPermissionsProps = {
     name: string | string[];
     permissions: Record<string, {
@@ -1786,5 +2334,5 @@ declare const WithPermissions: ({ rbacResource, rbacPermissions, children, }: Wi
  */
 declare const checkRbacPermission: (rbacPermissions: object, rbacResource: string, enableRBAC?: boolean) => boolean;
 
-export { ALPHANUMERIC_32_REGEX, ANONYMOUS_USERNAME, AuthContext, AuthContextProvider, AuthProvider, CHAT_AREA_SIZE, LOCAL_STORAGE_KEYS, MAX_INITIAL_WEBSOCKET_CONNECTION_ATTEMPTS, MENTOR_CHAT_DOCUMENTS_EXTENSIONS, METADATAS, MentorProvider, REQUIRED_ACTIONS_FOR_GROUPS, STREAMING_CONTENT_BUFFER_THRESHOLD, STREAMING_CONTENT_FLUSH_INTERVAL, SUBSCRIPTION_MESSAGES, SUBSCRIPTION_PACKAGES, SUBSCRIPTION_PACKAGES_V2, SUBSCRIPTION_TRIGGERS, SUBSCRIPTION_V2_TRIGGERS, SubscriptionFlow, SubscriptionFlowV2, TOOLS, TenantContext, TenantContextProvider, TenantProvider, TimeTracker, WithFormPermissions, WithPermissions, addFiles, addProtocolToUrl, advancedTabs, advancedTabsProperties, chatActions, chatSliceReducerShared, checkModelAvailable, checkOllamaHealth, checkRbacPermission, clearAuthCookies, clearCookies, clearCurrentTenantCookie, clearFiles, combineCSVData, convertToOllamaMessages, createFileReference, createMultipleFileReferences, csvDataToText, defaultSessionIds, deleteCookie, deleteCookieOnAllDomains, filesReducer, filesSlice, formatRelativeTime, getAuthSpaJoinUrl, getCookieValue, getDomainParts, getFileInfo, getInitials, getLocalLLMSystemPrompt, getNextNavigation, getParentDomain, getPlatform, getPlatformKey, getTimeAgo, getUserName, handleLogout, isAlphaNumeric32, isExpo, isInIframe, isJSON, isLoggedIn, isNode, isReactNative, isTauri, isWeb, loadMetadataConfig, markdownToPlainText, monetizationSlice, parseCSV, redirectToAuthSpa, redirectToAuthSpaJoinTenant, removeFile, requestPresignedUrl, safeRequire, selectActiveChatMessages, selectActiveTab, selectArtifactsEnabled, selectChats, selectCurrentStreamingArtifact, selectCurrentStreamingMessage, selectDocumentFilter, selectIframeContext, selectIsError, selectIsPending, selectIsStopped, selectIsTyping, selectLastArtifactContentFlushTime, selectMetadata, selectNumberOfActiveChatMessages, selectSessionId, selectSessionIds, selectShouldStartNewChat, selectShowingSharedChat, selectStatus, selectStreaming, selectStreamingArtifactContentBuffer, selectStreamingArtifactFullContent, selectToken, selectTokenEnabled, selectTools, sendMessageToParentWebsite, setAccessCheckResponse, setAdvancedDisplayMonetizationCheckoutModal, setCookieForAuth, setDisplayMonetizationCheckoutModal, showMonetizationCheckoutModal, streamOllamaChat, syncAuthToCookies, tenantKeySchema, tenantSchema, translatePrompt, updateFileMetadata, updateFileProgress, updateFileRetryCount, updateFileStatus, updateFileUrl, updateFileUrlFromWebSocket, uploadToS3, useAdvancedChat, useAuthContext, useAuthProvider, useChat, useDayJs, useExternalPricingPlan, useMentorSettings, useMentorTools, useProfileImageUpload, useStripeUpgrade, useSubscriptionHandler, useSubscriptionHandlerV2, useTenantContext, useTenantMetadata, useTimeTracker, useTimeTrackerNative, useUserProfileUpdate, userDataSchema, validateFile };
-export type { AdvancedTab, ArtifactData, ArtifactPayload, ArtifactVersion, AttachedFile, AuthContextType, ChatMode, ChatSliceState, ChatState, ChatStatus, CreateStripeCustomerPortalRequest, Error402MessageData, FileAttachment, FileInfo, FileProcessingEvent, FileReference, FileUploadState, FilesState, HandleLogoutOptions, Message, MessageAction, MonetizationState, OAuthRequiredData, OAuthResolvedData, OllamaChatRequest, OllamaChatStreamResponse, OllamaMessage, OllamaStreamCallbacks, PricingModalData, Prompt, RedirectToAuthSpaOptions, SendMessageOptions, SessionIds, StreamingArtifact, StreamingMessage, StripeUpgradePlan, SubscriptionFlowConfig, SubscriptionFlowConfigV2, Tenant, TenantContextType, TenantKeyMentorIdParams, TenantMetadata, TimeTrackerConfig, TimeTrackerState, TopTrialBannerProps, UploadProgressCallback, UseChatProps, UseChatReturn, UseExternalPricingProps, UseProfileImageUploadOptions, UseProfileImageUploadReturn, UseTimeTrackerConfig, UseTimeTrackerNativeConfig, UseTimeTrackerNativeReturn, UseTimeTrackerReturn, UseUserProfileUpdateResult, UserProfileUpdateData };
+export { ALPHANUMERIC_32_REGEX, ANONYMOUS_USERNAME, AuthContext, AuthContextProvider, AuthProvider, CHAT_AREA_SIZE, CacheKeys, DEFAULT_DISCLAIMER_CONTENT, LOCAL_STORAGE_KEYS, MAX_INITIAL_WEBSOCKET_CONNECTION_ATTEMPTS, MENTOR_CHAT_DOCUMENTS_EXTENSIONS, MENTOR_VISIBILITY, MENTOR_VISIBILITY_VALUES, METADATAS, MentorProvider, REQUIRED_ACTIONS_FOR_GROUPS, RemoteEvents, STREAMING_CONTENT_BUFFER_THRESHOLD, STREAMING_CONTENT_FLUSH_INTERVAL, SUBSCRIPTION_MESSAGES, SUBSCRIPTION_PACKAGES, SUBSCRIPTION_PACKAGES_V2, SUBSCRIPTION_TRIGGERS, SUBSCRIPTION_V2_TRIGGERS, ServiceWorkerProvider, SubscriptionFlow, SubscriptionFlowV2, TOOLS, TenantContext, TenantContextProvider, TenantProvider, TimeTracker, WithFormPermissions, WithPermissions, addFiles, addMessage, addProtocolToUrl, advancedTabs, advancedTabsProperties, chatActions, chatInputSlice, chatInputSliceActions, chatInputSliceReducer, chatInputSliceSelectors, chatSliceReducerShared, checkModelAvailable, checkOllamaHealth, checkRbacPermission, clearAllCaches, clearApiCache, clearAuthCookies, clearCookies, clearCurrentTenantCookie, clearFiles, clearMessages, combineCSVData, convertToOllamaMessages, createFileReference, createMultipleFileReferences, csvDataToText, defaultSessionIds, deleteCookie, deleteCookieOnAllDomains, enableChatActionsPopup, eventBus, fetchWithCache, filesReducer, filesSlice, formatRelativeTime, getAuthSpaJoinUrl, getCacheStatus, getCachedApiResponse, getCookieValue, getDomainParts, getFileInfo, getInitials, getLocalLLMSystemPrompt, getNextNavigation, getParentDomain, getPlatform, getPlatformKey, getServiceWorkerStatus, getStoredUserName, getTimeAgo, getUserEmail, getUserName, handleLogout, hostChatReducer, hostChatSlice, initServiceWorker, isAlphaNumeric32, isExpo, isFileAccepted, isInIframe, isJSON, isLoggedIn, isNode, isReactNative, isSafariBrowser, isServiceWorkerSupported, isStripeActivated, isTauri, isTauriOfflineMode, isWeb, loadMetadataConfig, markdownToPlainText, monetizationSlice, onStatusChange, onUpdate, parseCSV, preCacheMentorData, rbacReducer, redirectToAuthSpa, redirectToAuthSpaJoinTenant, registerServiceWorker, removeFile, requestPresignedUrl, safeRequire, selectActiveChatMessages, selectActiveTab, selectArtifactsEnabled, selectAttachedFiles, selectChats, selectCurrentStreamingArtifact, selectCurrentStreamingMessage, selectDocumentFilter, selectEnableChatActionsPopup, selectIframeContext, selectIsError, selectIsPending, selectIsStopped, selectIsTyping, selectLastArtifactContentFlushTime, selectMetadata, selectNumberOfActiveChatMessages, selectRbacPermissions, selectSessionId, selectSessionIds, selectShouldStartNewChat, selectShowingSharedChat, selectStatus, selectStreaming, selectStreamingArtifactContentBuffer, selectStreamingArtifactFullContent, selectToken, selectTokenEnabled, selectTools, sendMessageToParentWebsite, setAccessCheckResponse, setAdvancedDisplayMonetizationCheckoutModal, setCachedApiResponse, setCookieForAuth, setDisplayMonetizationCheckoutModal, setError402Detected, setFreeTrialUsageOptions, setOfflineStatus, setOpenAppleRestrictionModal, setOpenPricingModal, setPricingModalData, setSubscriptionStatus, setTauriMode, setTopBannerOptions, setupNetworkListeners, showMonetizationCheckoutModal, skipWaiting, streamOllamaChat, subscriptionReducer, subscriptionSlice, syncAuthToCookies, tenantKeySchema, tenantSchema, topBannerReducer, topBannerSlice, translatePrompt, unregisterServiceWorker, updateFileMetadata, updateFileProgress, updateFileRetryCount, updateFileStatus, updateFileUrl, updateFileUrlFromWebSocket, updateRbacPermissions, uploadToS3, use402ErrorCheck, useAccessingPublicRoute, useAdvancedChat, useAuthContext, useAuthProvider, useAxdToken, useCachedSessionId, useChat, useChatFileUpload, useCurrentTenant, useDayJs, useDmToken, useEmbedMode, useEventCallback, useEventListener, useExternalPricingPlan, useFileDragDrop, useIsAdmin, useIsomorphicLayoutEffect, useLocalStorage, useMentorSettings, useMentorTools, useModelFileUploadCapabilities, useOS, useProfileImageUpload, useResponsive, useServiceWorker, useShowAttachment, useShowFreeTrialDialog, useShowVoiceCall, useShowVoiceRecorder, useStripeUpgrade, useSubscriptionHandler, useSubscriptionHandlerV2, useTenantContext, useTenantMetadata, useTimeTracker, useTimeTrackerNative, useTimer, useUserAgreement, useUserData, useUserProfileUpdate, useUserTenants, useUsername, useVisitingTenant, useVoiceChat, useWelcome as useWelcomeMessage, userDataSchema, validateFile };
+export type { AdvancedTab, ArtifactData, ArtifactPayload, ArtifactVersion, AttachedFile, AuthContextType, ChatInputState, ChatMode, ChatSliceState, ChatState, ChatStatus, CreateStripeCustomerPortalRequest, Error402MessageData, FileAttachment, FileInfo, FileProcessingEvent, FileReference, FileUploadCapabilities, FileUploadState, FilesState, HandleLogoutOptions, HostChatState, Message$1 as Message, MessageAction, MonetizationState, OAuthRequiredData, OAuthResolvedData, OllamaChatRequest, OllamaChatStreamResponse, OllamaMessage, OllamaStreamCallbacks, PricingModalData$1 as PricingModalData, PricingTablePayload, Prompt, RbacPermissions, RbacState, RedirectToAuthSpaOptions, SendMessageOptions, ServiceWorkerStatus, SessionIds, StreamingArtifact, StreamingMessage, StripeUpgradePlan, SubscriptionFlowConfig, SubscriptionFlowConfigV2, SubscriptionState, Tenant, TenantContextType, TenantKeyMentorIdParams, TenantMetadata, TimeTrackerConfig, TimeTrackerState, TopBannerOptions, TopBannerState, TopTrialBannerProps, UploadProgressCallback, UseChatProps, UseChatReturn, UseExternalPricingProps, UseProfileImageUploadOptions, UseProfileImageUploadReturn, UseTimeTrackerConfig, UseTimeTrackerNativeConfig, UseTimeTrackerNativeReturn, UseTimeTrackerReturn, UseUserProfileUpdateResult, UserProfileUpdateData };