@iota-uz/sdk 0.4.11 → 0.4.13

package/dist/bichat/index.d.ts

@@ -4,6 +4,89 @@ import react__default, { ReactNode, Component, ErrorInfo, FC, HTMLAttributes, Re
 import { I as InitialContext, A as AppConfig$1, L as LocaleContext$1, T as TenantContext$1, U as UserContext$1 } from '../index-Cs_xWkhC.js';
 import { File as File$1 } from '@phosphor-icons/react';
 
+/**
+ * Split data source interfaces for BiChat.
+ *
+ * ChatDataSource was a single interface mixing CRUD, streaming, artifacts,
+ * and admin. These focused interfaces let consumers implement only what
+ * they need. ChatDataSource keeps the same shape (with optional artifact
+ * and admin methods) for backwards compatibility — it is NOT a strict
+ * intersection of these interfaces.
+ */
+
+interface SessionStore {
+    createSession(): Promise<Session$1>;
+    fetchSession(id: string): Promise<{
+        session: Session$1;
+        turns: ConversationTurn$1[];
+        pendingQuestion?: PendingQuestion$1 | null;
+    } | 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;
+    }>;
+}
+interface MessageTransport {
+    sendMessage(sessionId: string, content: string, attachments?: Attachment$1[], signal?: AbortSignal, options?: SendMessageOptions): AsyncGenerator<StreamChunk>;
+    submitQuestionAnswers(sessionId: string, questionId: string, answers: QuestionAnswers): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    rejectPendingQuestion(sessionId: string): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+}
+interface ArtifactStore {
+    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>;
+}
+interface AdminStore {
+    listUsers(): Promise<SessionUser[]>;
+    listAllSessions(options?: {
+        limit?: number;
+        offset?: number;
+        includeArchived?: boolean;
+        userId?: string | null;
+    }): Promise<{
+        sessions: Array<Session$1 & {
+            owner: SessionUser;
+        }>;
+        total: number;
+        hasMore: boolean;
+    }>;
+}
+
 /**
  * Type definitions for BI-Chat UI components
  */
@@ -202,6 +285,37 @@ interface QuestionAnswerData {
 interface QuestionAnswers {
     [questionId: string]: QuestionAnswerData;
 }
+type StreamEvent = {
+    type: 'content';
+    content: string;
+} | {
+    type: 'tool_start';
+    tool: StreamToolPayload;
+} | {
+    type: 'tool_end';
+    tool: StreamToolPayload;
+} | {
+    type: 'usage';
+    usage: DebugUsage$1;
+} | {
+    type: 'user_message';
+    sessionId: string;
+} | {
+    type: 'interrupt';
+    interrupt: StreamInterruptPayload;
+    sessionId?: string;
+} | {
+    type: 'done';
+    sessionId?: string;
+    generationMs?: number;
+} | {
+    type: 'error';
+    error: string;
+};
+/**
+ * @deprecated Use `StreamEvent` instead. `StreamChunk` is kept for backwards
+ * compatibility but the flat all-optional shape is unsound.
+ */
 interface StreamChunk {
     type: 'chunk' | 'content' | 'tool_start' | 'tool_end' | 'usage' | 'done' | 'error' | 'user_message' | 'interrupt';
     content?: string;
@@ -281,6 +395,17 @@ interface SessionGroup {
     name: string;
     sessions: Session$1[];
 }
+
+/**
+ * Full data source interface for BiChat.
+ *
+ * Combines session CRUD, message transport, and optional artifact/admin
+ * methods. Existing implementations satisfy this without changes.
+ *
+ * For new code, prefer the focused interfaces (`SessionStore`,
+ * `MessageTransport`, `ArtifactStore`, `AdminStore`) when you only need a
+ * subset of capabilities.
+ */
 interface ChatDataSource {
     createSession(): Promise<Session$1>;
     fetchSession(id: string): Promise<{
@@ -321,6 +446,11 @@ interface ChatDataSource {
         success: boolean;
         error?: string;
     }>;
+    /**
+     * @deprecated Pass `onSessionCreated` to `ChatSessionProvider` instead.
+     * This method couples navigation to the data source, causing component
+     * remounts during active streams.
+     */
     navigateToSession?(sessionId: string): void;
     listSessions(options?: {
         limit?: number;
@@ -353,15 +483,19 @@ interface ChatSessionStateValue {
     currentSessionId?: string;
     fetching: boolean;
     error: string | null;
+    errorRetryable: boolean;
     debugMode: boolean;
     sessionDebugUsage: SessionDebugUsage;
     debugLimits: DebugLimits | null;
     setError: (error: string | null) => void;
+    retryFetchSession: () => void;
 }
 interface ChatMessagingStateValue {
     turns: ConversationTurn$1[];
     streamingContent: string;
     isStreaming: boolean;
+    streamError: string | null;
+    streamErrorRetryable: boolean;
     loading: boolean;
     pendingQuestion: PendingQuestion$1 | null;
     codeOutputs: CodeOutput$1[];
@@ -375,6 +509,8 @@ interface ChatMessagingStateValue {
     handleCopy: (text: string) => Promise<void>;
     handleSubmitQuestionAnswers: (answers: QuestionAnswers) => void;
     handleRejectPendingQuestion: () => Promise<void>;
+    retryLastMessage: () => Promise<void>;
+    clearStreamError: () => void;
     cancel: () => void;
     setCodeOutputs: (outputs: CodeOutput$1[]) => void;
 }
@@ -384,13 +520,23 @@ interface ChatInputStateValue {
     messageQueue: QueuedMessage[];
     setMessage: (message: string) => void;
     setInputError: (error: string | null) => void;
-    handleSubmit: (e: React.FormEvent, attachments?: Attachment$1[]) => void;
+    handleSubmit: (e: {
+        preventDefault: () => void;
+    }, attachments?: Attachment$1[]) => void;
     handleUnqueue: () => {
         content: string;
         attachments: Attachment$1[];
     } | null;
+    enqueueMessage: (content: string, attachments: Attachment$1[]) => boolean;
+    removeQueueItem: (index: number) => void;
+    updateQueueItem: (index: number, content: string) => void;
 }
 interface ChatSessionContextValue extends ChatSessionStateValue, ChatMessagingStateValue, ChatInputStateValue {
+    /**
+     * @deprecated Use `retryLastMessage` from `ChatMessagingStateValue` instead.
+     * This field is not populated by the current ChatMachine-based provider and
+     * will always be `undefined` at runtime.
+     */
     handleRetry?: () => Promise<void>;
 }
 
@@ -428,6 +574,13 @@ interface ChatSessionProps {
     sessionId?: string;
     /** Optional rate limiter to throttle sendMessage */
     rateLimiter?: RateLimiter;
+    /**
+     * Called when a new session is created (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;
     /** Alias for isReadOnly (preferred) */
     readOnly?: boolean;
     isReadOnly?: boolean;
@@ -448,6 +601,8 @@ interface ChatSessionProps {
     onBack?: () => void;
     /** Custom verbs for the typing indicator (e.g. ['Thinking', 'Analyzing', ...]) */
     thinkingVerbs?: string[];
+    /** Callback invoked after an archived session is restored (e.g. to navigate or refresh) */
+    onSessionRestored?: (sessionId: string) => void;
     /** Enables the built-in right-side artifacts panel for persisted session artifacts */
     showArtifactsPanel?: boolean;
     /** Initial expanded state for artifacts panel when no persisted preference exists */
@@ -850,6 +1005,8 @@ interface MessageInputProps {
         content: string;
         attachments: Attachment$1[];
     } | null;
+    onRemoveQueueItem?: (index: number) => void;
+    onUpdateQueueItem?: (index: number, content: string) => void;
     placeholder?: string;
     maxFiles?: number;
     maxFileSize?: number;
@@ -1185,7 +1342,7 @@ interface ToastContainerProps {
     /** Label for dismiss buttons */
     dismissLabel?: string;
 }
-declare function ToastContainer({ toasts, onDismiss, dismissLabel }: ToastContainerProps): react_jsx_runtime.JSX.Element;
+declare function ToastContainer({ toasts, onDismiss, dismissLabel }: ToastContainerProps): react_jsx_runtime.JSX.Element | null;
 
 /**
  * ConfirmModal Component
@@ -1350,22 +1507,6 @@ interface AllChatsListProps {
 }
 declare function AllChatsList({ dataSource, onSessionSelect, activeSessionId }: AllChatsListProps): react_jsx_runtime.JSX.Element;
 
-/**
- * TabBar Component
- * Horizontal tabs with animated indicator for switching between views
- * Generic: accepts any set of tabs via props
- */
-interface TabBarProps {
-    tabs: Array<{
-        id: string;
-        label: string;
-    }>;
-    activeTab: string;
-    onTabChange: (tabId: string) => void;
-}
-declare function TabBar({ tabs, activeTab, onTabChange }: TabBarProps): react_jsx_runtime.JSX.Element | null;
-declare const MemoizedTabBar: react.MemoExoticComponent<typeof TabBar>;
-
 interface UserFilterProps {
     users: SessionUser[];
     selectedUser: SessionUser | null;
@@ -1489,10 +1630,12 @@ interface StreamErrorProps {
     onRetry?: () => void;
     /** Callback to regenerate the message */
     onRegenerate?: () => void;
+    /** Callback to dismiss the error */
+    onDismiss?: () => void;
     /** Whether to show compact mode (less padding) */
     compact?: boolean;
 }
-declare function StreamError({ error, onRetry, onRegenerate, compact, }: StreamErrorProps): react_jsx_runtime.JSX.Element;
+declare function StreamError({ error, onRetry, onRegenerate, onDismiss, compact, }: StreamErrorProps): react_jsx_runtime.JSX.Element;
 
 interface ActionableMessage {
     id: string;
@@ -1793,7 +1936,7 @@ declare function useStreaming(options?: UseStreamingOptions): {
  * Translation hook using locale from IotaContext
  */
 declare function useTranslation(): {
-    t: (key: string, params?: Record<string, any>) => string;
+    t: (key: string, params?: Record<string, string | number | boolean>) => string;
     locale: string;
 };
 
@@ -2456,29 +2599,6 @@ declare const dropdownVariants: {
         };
     };
 };
-/**
- * Toast notification
- */
-declare const toastVariants: {
-    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
  */
@@ -2539,15 +2659,30 @@ declare const errorMessageVariants: {
 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). */
+    /**
+     * 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, children }: ChatSessionProviderProps): react_jsx_runtime.JSX.Element;
+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. Use when component can receive values via props (e.g. SessionArtifactsPanel with artifactsInvalidationTrigger prop). */
+/** Returns messaging context or null when outside ChatSessionProvider. */
 declare function useOptionalChatMessaging(): ChatMessagingStateValue | null;
 declare function useChatInput(): ChatInputStateValue;
 
@@ -2617,21 +2752,27 @@ type IotaContext = Omit<InitialContext, 'config' | 'extensions'> & {
 };
 declare global {
     interface Window {
-        __BICHAT_CONTEXT__: IotaContext;
+        __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({ children }: IotaContextProviderProps): react_jsx_runtime.JSX.Element;
+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;
@@ -2660,11 +2801,12 @@ interface ConfigProviderProps {
     children: ReactNode;
 }
 /**
- * ConfigProvider component
- * Provides configuration to the BiChat library
+ * @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.__BICHAT_CONTEXT__ when config is not provided
+ * @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;
@@ -2774,7 +2916,11 @@ interface HttpDataSourceConfig {
     csrfToken?: string | (() => string);
     headers?: Record<string, string>;
     timeout?: number;
-    /** Optional: called when a new session is created so the host app can navigate (e.g. SPA router) */
+    /**
+     * @deprecated Pass `onSessionCreated` to `ChatSessionProvider` or
+     * `ChatSession` instead. Coupling navigation to the data source causes
+     * component remounts during active streams.
+     */
     navigateToSession?: (sessionId: string) => void;
 }
 interface SessionState {
@@ -3156,6 +3302,241 @@ interface UserTurn {
     createdAt: string;
 }
 
+/**
+ * Internal types for the ChatMachine.
+ *
+ * These are implementation details — consumers use the existing
+ * ChatSessionStateValue / ChatMessagingStateValue / ChatInputStateValue
+ * types via the public hooks.
+ */
+
+interface ChatMachineConfig {
+    dataSource: ChatDataSource;
+    rateLimiter: RateLimiter;
+    onSessionCreated?: (sessionId: string) => void;
+}
+/**
+ * Mirrors ChatSessionStateValue. Methods are stable (bound once on
+ * machine construction) so they never trigger re-renders by identity change.
+ */
+interface SessionSnapshot {
+    session: Session$1 | null;
+    currentSessionId?: string;
+    fetching: boolean;
+    error: string | null;
+    errorRetryable: boolean;
+    debugMode: boolean;
+    sessionDebugUsage: SessionDebugUsage;
+    debugLimits: DebugLimits | null;
+    setError: (error: string | null) => void;
+    retryFetchSession: () => void;
+}
+/** Mirrors ChatMessagingStateValue. */
+interface MessagingSnapshot {
+    turns: ConversationTurn$1[];
+    streamingContent: string;
+    isStreaming: boolean;
+    streamError: string | null;
+    streamErrorRetryable: boolean;
+    loading: boolean;
+    pendingQuestion: PendingQuestion$1 | null;
+    codeOutputs: CodeOutput$1[];
+    isCompacting: boolean;
+    compactionSummary: string | null;
+    artifactsInvalidationTrigger: number;
+    sendMessage: (content: string, attachments?: Attachment$1[]) => Promise<void>;
+    handleRegenerate?: (turnId: string) => Promise<void>;
+    handleEdit?: (turnId: string, newContent: string) => Promise<void>;
+    handleCopy: (text: string) => Promise<void>;
+    handleSubmitQuestionAnswers: (answers: QuestionAnswers) => void;
+    handleRejectPendingQuestion: () => Promise<void>;
+    retryLastMessage: () => Promise<void>;
+    clearStreamError: () => void;
+    cancel: () => void;
+    setCodeOutputs: (outputs: CodeOutput$1[]) => void;
+}
+/** Mirrors ChatInputStateValue. */
+interface InputSnapshot {
+    message: string;
+    inputError: string | null;
+    messageQueue: QueuedMessage[];
+    setMessage: (message: string) => void;
+    setInputError: (error: string | null) => void;
+    handleSubmit: (e: {
+        preventDefault: () => void;
+    }, attachments?: Attachment$1[]) => void;
+    handleUnqueue: () => {
+        content: string;
+        attachments: Attachment$1[];
+    } | null;
+    enqueueMessage: (content: string, attachments: Attachment$1[]) => boolean;
+    removeQueueItem: (index: number) => void;
+    updateQueueItem: (index: number, content: string) => void;
+}
+
+/**
+ * ChatMachine — framework-agnostic state machine for BiChat.
+ *
+ * Owns all async logic that was previously in ChatContext.tsx:
+ * - Session fetch (with race-condition guards)
+ * - Message sending + streaming
+ * - Slash commands (/debug, /clear, /compact)
+ * - HITL question submission / rejection
+ * - Message queue (auto-drain)
+ * - Rate limiting
+ * - Abort / cancel
+ *
+ * Zero React dependency. Designed for `useSyncExternalStore`:
+ * three subscribe/getSnapshot pairs map to the existing 3-context split.
+ */
+
+type Listener = () => void;
+declare class ChatMachine {
+    private dataSource;
+    private rateLimiter;
+    private onSessionCreated?;
+    private state;
+    private abortController;
+    private lastSendAttempt;
+    /** Prevents fetchSession effect from clobbering state while stream is active. */
+    private sendingSessionId;
+    private fetchCancelled;
+    private disposed;
+    /** Memoized sessionDebugUsage — avoids unnecessary session re-renders during streaming. */
+    private lastSessionDebugUsage;
+    private sessionListeners;
+    private messagingListeners;
+    private inputListeners;
+    private cachedSessionSnapshot;
+    private cachedMessagingSnapshot;
+    private cachedInputSnapshot;
+    private sessionSnapshotVersion;
+    private messagingSnapshotVersion;
+    private inputSnapshotVersion;
+    private lastSessionSnapshotVersion;
+    private lastMessagingSnapshotVersion;
+    private lastInputSnapshotVersion;
+    readonly setError: (error: string | null) => void;
+    readonly retryFetchSession: () => void;
+    readonly sendMessage: (content: string, attachments?: Attachment$1[]) => Promise<void>;
+    readonly handleRegenerate: (turnId: string) => Promise<void>;
+    readonly handleEdit: (turnId: string, newContent: string) => Promise<void>;
+    readonly handleCopy: (text: string) => Promise<void>;
+    readonly handleSubmitQuestionAnswers: (answers: QuestionAnswers) => void;
+    readonly handleRejectPendingQuestion: () => Promise<void>;
+    readonly retryLastMessage: () => Promise<void>;
+    readonly clearStreamError: () => void;
+    readonly cancel: () => void;
+    readonly setCodeOutputs: (outputs: CodeOutput$1[]) => void;
+    readonly setMessage: (message: string) => void;
+    readonly setInputError: (error: string | null) => void;
+    readonly handleSubmit: (e: {
+        preventDefault: () => void;
+    }, attachments?: Attachment$1[]) => void;
+    readonly handleUnqueue: () => {
+        content: string;
+        attachments: Attachment$1[];
+    } | null;
+    readonly enqueueMessage: (content: string, attachments: Attachment$1[]) => boolean;
+    readonly removeQueueItem: (index: number) => void;
+    readonly updateQueueItem: (index: number, content: string) => void;
+    constructor(config: ChatMachineConfig);
+    /**
+     * Set the active session ID. Triggers fetch when transitioning to a real
+     * session, or resets state for 'new'/undefined.
+     */
+    setSessionId(id: string | undefined): void;
+    /**
+     * Update mutable config that may change across parent re-renders.
+     * Called from the React provider's useEffect to keep the machine in sync.
+     */
+    updateConfig(config: Pick<ChatMachineConfig, 'dataSource' | 'onSessionCreated'>): void;
+    dispose(): void;
+    subscribeSession: (listener: Listener) => (() => void);
+    getSessionSnapshot: () => SessionSnapshot;
+    subscribeMessaging: (listener: Listener) => (() => void);
+    getMessagingSnapshot: () => MessagingSnapshot;
+    subscribeInput: (listener: Listener) => (() => void);
+    getInputSnapshot: () => InputSnapshot;
+    private _updateSession;
+    private _notifySession;
+    private _updateMessaging;
+    private _notifyMessaging;
+    private _updateInput;
+    private _notifyInput;
+    private _persistQueue;
+    private _fetchSessionIfNeeded;
+    /** Sets turns from fetch, preserving pending user-only turns if server hasn't caught up. */
+    private _setTurnsFromFetch;
+    private _setError;
+    private _retryFetchSession;
+    private _clearStreamError;
+    private _cancel;
+    private _setCodeOutputs;
+    private _setMessage;
+    private _setInputError;
+    private _executeSlashCommand;
+    /**
+     * Public entry point (no options). Calls _sendMessageCore internally.
+     */
+    private _sendMessage;
+    /**
+     * Internal entry point with options (for regenerate/edit).
+     */
+    private _sendMessageDirect;
+    /**
+     * Core send-message logic. Handles slash commands, rate limiting, streaming,
+     * session creation, optimistic turns, and auto-queue-drain.
+     */
+    private _sendMessageCore;
+    private _retryLastMessage;
+    private _handleRegenerate;
+    private _handleEdit;
+    private _handleCopy;
+    private _handleSubmitQuestionAnswers;
+    private _handleRejectPendingQuestion;
+    private _handleSubmit;
+    private _handleUnqueue;
+    private _enqueueMessage;
+    private _removeQueueItem;
+    private _updateQueueItem;
+}
+
+/**
+ * SSE stream parser for consuming Server-Sent Events.
+ */
+
+interface SSEEvent {
+    type: string;
+    content?: string;
+    error?: string;
+    sessionId?: string;
+    toolName?: string;
+    toolCallId?: string;
+    durationMs?: number;
+    success?: boolean;
+    [key: string]: unknown;
+}
+/**
+ * Parses an SSE stream and yields parsed JSON events.
+ */
+declare function parseSSEStream(reader: ReadableStreamDefaultReader<Uint8Array>): AsyncGenerator<SSEEvent, void, unknown>;
+/**
+ * Parses BiChat SSE stream with normalization and terminal event guarantee.
+ *
+ * Guarantees that the generator always yields a terminal event (`done` or
+ * `error`) as its last item — even when the underlying stream closes silently
+ * without one.
+ */
+declare function parseBichatStream(reader: ReadableStreamDefaultReader<Uint8Array>): AsyncGenerator<StreamChunk, void, unknown>;
+/**
+ * Type-safe version of `parseBichatStream` that yields `StreamEvent`
+ * discriminated union members instead of the flat `StreamChunk`.
+ *
+ * Use this in new code for proper type narrowing on `event.type`.
+ */
+declare function parseBichatStreamEvents(reader: ReadableStreamDefaultReader<Uint8Array>): AsyncGenerator<StreamEvent, void, unknown>;
+
 /**
  * File Utilities
  * Validation, conversion, and formatting for file attachments
@@ -3234,4 +3615,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, _default$1 as Alert, AllChatsList, type AppConfig, _default as ArchiveBanner, ArchivedChatList, type Artifact$1 as Artifact, 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 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 ChartData, type ChartSeries, type ChatDataSource, ChatHeader, type ChatInputStateValue, type ChatMessagingStateValue, ChatSession, type ChatSessionContextValue, ChatSessionProvider, type ChatSessionStateValue, type Citation$1 as Citation, MemoizedCodeBlock as CodeBlock, type CodeOutput$1 as CodeOutput, CodeOutputsPanel, CompactionDoodle, ConfigProvider, ConfirmModal, type ConfirmModalProps, ConfirmationStep, type ConversationTurn$1 as ConversationTurn, DateGroupHeader, DebugPanel, type DebugPanelProps, DefaultErrorContent, DownloadCard, MemoizedEditableText as EditableText, type EditableTextProps, type EditableTextRef, MemoizedEmptyState as EmptyState, type EmptyStateProps, ErrorBoundary, type FileValidationError, type FileVisual, HttpDataSource, type HttpDataSourceConfig, type ImageAttachment, type ImageLoadingStatus, ImageModal, InlineQuestionForm, type IotaContext, IotaContextProvider, ListItemSkeleton, MemoizedLoadingSpinner as LoadingSpinner, type LocaleContext, MemoizedMarkdownRenderer as MarkdownRenderer, MessageActions, MessageInput, type MessageInputProps, type MessageInputRef, MessageList, MessageRole, 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, 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 SessionUser, type ShortcutConfig, Sidebar, type SidebarDrawerProps, type SidebarProps, MemoizedSkeleton as Skeleton, SkeletonAvatar, SkeletonCard, SkeletonGroup, type SkeletonGroupProps, type SkeletonProps, SkeletonText, SkipLink, Slot, type SlotProps, SourcesPanel, type StreamChunk, StreamError, StreamingCursor, SystemMessage, MemoizedTabBar as TabBar, TableExportButton, TableWithExport, type TenantContext, type Theme, type ThemeBorderRadius, type ThemeColors, ThemeProvider, type ThemeSpacing, Toast, 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 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, getValidChildren, groupSessionsByDate, hasPermission, isImageMimeType, isPermissionDeniedError, lightTheme, listItemVariants, messageContainerVariants, messageVariants, scaleFadeVariants, sessionItemVariants, staggerContainerVariants, toErrorDisplay, toastVariants, typingDotVariants, useActionButtonContext, useAttachments, useAutoScroll, useAvatarContext, useBubbleContext, useChatInput, useChatMessaging, useChatSession, useConfig, 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 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 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 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, CompactionDoodle, ConfigProvider, ConfirmModal, type ConfirmModalProps, ConfirmationStep, type ConversationTurn$1 as ConversationTurn, DateGroupHeader, DebugPanel, type DebugPanelProps, DefaultErrorContent, DownloadCard, MemoizedEditableText as EditableText, type EditableTextProps, type EditableTextRef, MemoizedEmptyState as EmptyState, type EmptyStateProps, ErrorBoundary, type FileValidationError, type FileVisual, HttpDataSource, type HttpDataSourceConfig, type ImageAttachment, type ImageLoadingStatus, ImageModal, InlineQuestionForm, 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, 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, SourcesPanel, type StreamChunk, StreamError, type StreamEvent, StreamingCursor, SystemMessage, TableExportButton, TableWithExport, type TenantContext, type Theme, type ThemeBorderRadius, type ThemeColors, ThemeProvider, type ThemeSpacing, Toast, 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 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, getValidChildren, groupSessionsByDate, hasPermission, isImageMimeType, isPermissionDeniedError, lightTheme, listItemVariants, messageContainerVariants, messageVariants, parseBichatStream, parseBichatStreamEvents, parseSSEStream, scaleFadeVariants, sessionItemVariants, staggerContainerVariants, toErrorDisplay, typingDotVariants, useActionButtonContext, useAttachments, useAutoScroll, useAvatarContext, useBubbleContext, useChatInput, useChatMessaging, useChatSession, useConfig, useFocusTrap, useImageGallery, useIotaContext, useKeyboardShortcuts, useLongPress, useMarkdownCopy, useMessageActions, useModalLock, useOptionalChatMessaging, useRequiredConfig, useScrollToBottom, useSidebarState, useStreaming, useTheme, useToast, useTranslation, useTurnContext, validateAttachmentFile, validateFileCount, validateImageFile, verbTransitionVariants };