@iota-uz/sdk 0.4.34 → 0.4.35

package/dist/bichat/index.d.cts

@@ -370,6 +370,9 @@ type StreamEvent = {
     type: "interrupt";
     interrupt: StreamInterruptPayload;
     sessionId?: string;
+} | {
+    type: "text_block_end";
+    seq: number;
 } | {
     type: "done";
     sessionId?: string;
@@ -402,7 +405,7 @@ interface AsyncRunAccepted {
  * compatibility but the flat all-optional shape is unsound.
  */
 interface StreamChunk {
-    type: "chunk" | "content" | "thinking" | "tool_start" | "tool_end" | "usage" | "done" | "error" | "user_message" | "interrupt" | "snapshot" | "stream_started";
+    type: "chunk" | "content" | "thinking" | "tool_start" | "tool_end" | "usage" | "done" | "error" | "user_message" | "interrupt" | "snapshot" | "stream_started" | "text_block_end";
     content?: string;
     error?: string;
     sessionId?: string;
@@ -414,6 +417,27 @@ interface StreamChunk {
     snapshot?: StreamSnapshotPayload;
     /** Set when type is 'stream_started'; client should store for refresh-safe resume */
     runId?: string;
+    /**
+     * Zero-based ordinal of the assistant text segment that just ended.
+     * Populated only when type === "text_block_end". Used to split the
+     * accumulated assistant content into distinct blocks interleaved with
+     * tool_call UI (text → tool → text → tool → final_text).
+     */
+    textBlockSeq?: number;
+}
+/**
+ * Per-tenant active-run status event. Delivered via the
+ * GET /bi-chat/stream/active-runs SSE endpoint. The first batch after
+ * connect carries `event === "snapshot"` for each currently-running
+ * session; subsequent rows carry `event === "update"` as runs
+ * transition (queued → streaming → completed / cancelled / failed).
+ */
+interface ActiveRunDelivery {
+    event: "snapshot" | "update";
+    sessionId: string;
+    runId: string;
+    status: "queued" | "streaming" | "completed" | "cancelled" | "failed";
+    updatedAt: number;
 }
 interface StreamInterruptPayload {
     checkpointId: string;
@@ -531,6 +555,13 @@ interface SendMessageOptions {
     replaceFromMessageID?: string;
     reasoningEffort?: string;
     model?: string;
+    /**
+     * Client-generated idempotency key. Duplicate sends sharing the same
+     * requestId within the backend's dedupe window (~30 min) converge on
+     * a single server-side run. Omit to disable dedupe for a particular
+     * send; the data source auto-generates one per call otherwise.
+     */
+    requestId?: string;
 }
 interface SessionListResult$1 {
     sessions: Session$1[];
@@ -617,6 +648,32 @@ interface ChatDataSource {
      * Optional; if absent, resume is not supported.
      */
     resumeStream?(sessionId: string, runId: string, onChunk: (chunk: StreamChunk) => void, signal?: AbortSignal): Promise<void>;
+    /**
+     * Tail a run via native EventSource against GET /stream/events. Honours
+     * Last-Event-ID for auto-reconnect on wifi drops / tab sleep. Prefer
+     * over resumeStream when connecting to a run that was started by
+     * another tab (same request_id) or that needs to survive a reload
+     * via cursor-based replay. Optional; data sources that don't
+     * implement it fall back to resumeStream.
+     */
+    subscribeRunEvents?(sessionId: string, runId: string, options: {
+        lastEventId?: string;
+        onChunk: (chunk: StreamChunk) => void;
+        onError?: (event: Event) => void;
+        signal?: AbortSignal;
+    }): Promise<void>;
+    /**
+     * Subscribe to the per-tenant active-run fan-out
+     * (GET /stream/active-runs). Emits one "snapshot" event per
+     * currently-running session on connect, then live "update" deltas.
+     * Optional; data sources that don't implement it fall back to
+     * per-session polling via getStreamStatus.
+     */
+    subscribeActiveRuns?(options: {
+        onEvent: (event: ActiveRunDelivery) => void;
+        onError?: (event: Event) => void;
+        signal?: AbortSignal;
+    }): Promise<void>;
     listSessions(options?: {
         limit?: number;
         offset?: number;
@@ -2293,6 +2350,54 @@ declare function useStreaming(options?: UseStreamingOptions): {
     reset: () => void;
 };
 
+/**
+ * useActiveRuns — live map of per-session generation status.
+ *
+ * Subscribes to the data source's `subscribeActiveRuns` channel
+ * (`GET /bi-chat/stream/active-runs`) and maintains a
+ * sessionId → status dictionary so the sidebar can render a status
+ * dot next to each session card without polling /stream/status per
+ * session.
+ *
+ * The hook is a no-op when:
+ * - the data source does not implement subscribeActiveRuns (older
+ *   backends without the active-run index);
+ * - `enabled` is false (e.g. the user is offline).
+ */
+
+interface ActiveRunSnapshot {
+    runId: string;
+    status: ActiveRunDelivery['status'];
+    updatedAt: number;
+}
+interface UseActiveRunsOptions {
+    enabled?: boolean;
+    /** Optional hook for raw SSE errors. */
+    onError?: (event: Event) => void;
+    /**
+     * Keep terminal-status entries in the map for this many milliseconds
+     * before pruning them. Default 0 preserves the previous behaviour
+     * (synchronous delete). Useful when consumers want to render a
+     * "completed" pulse animation before the dot disappears.
+     */
+    retainTerminalMs?: number;
+    /**
+     * How long to wait for an initial snapshot batch before declaring
+     * the hook `ready` when the server has zero active runs.
+     * Default 250ms.
+     */
+    emptyStateTimeoutMs?: number;
+}
+interface UseActiveRunsResult {
+    /** sessionId → current live status. Terminal statuses are emitted then the entry is removed. */
+    runs: Record<string, ActiveRunSnapshot>;
+    /** True once the initial HGETALL snapshot is delivered. */
+    ready: boolean;
+    /** Convenience: undefined when not active. */
+    status: (sessionId: string) => ActiveRunDelivery['status'] | undefined;
+}
+declare function useActiveRuns(dataSource: Pick<ChatDataSource, 'subscribeActiveRuns'>, options?: UseActiveRunsOptions): UseActiveRunsResult;
+
 /**
  * Translation hook using locale from IotaContext
  */
@@ -3131,6 +3236,39 @@ interface SessionState {
     pendingQuestion?: PendingQuestion$1 | null;
 }
 
+/**
+ * Message sending, SSE streaming, and HITL question handling.
+ *
+ * @internal — Not part of the public API. Consumed by HttpDataSource.
+ */
+
+/**
+ * Thrown by {@link subscribeRunEvents} when the underlying EventSource
+ * emits `onerror` before the first event arrives within the
+ * initial-connect grace window. Distinguishes boundary failures
+ * (401 / 404 / 503) from transient mid-run flaps, which the browser's
+ * native auto-reconnect continues to handle silently.
+ */
+declare class RunEventsConnectError extends Error {
+    readonly cause?: Event;
+    constructor(message: string, cause?: Event);
+}
+interface SubscribeRunEventsOptions {
+    /** When set, start from the last seen event id instead of a full replay. */
+    lastEventId?: string;
+    /** Fires for every chunk (content / tool / snapshot / done / error / …). */
+    onChunk: (chunk: StreamChunk) => void;
+    /** Optional hook for raw SSE errors (connection blips, parse failures). */
+    onError?: (event: Event) => void;
+    /** AbortSignal closes the underlying EventSource. */
+    signal?: AbortSignal;
+}
+interface SubscribeActiveRunsOptions {
+    onEvent: (event: ActiveRunDelivery) => void;
+    onError?: (event: Event) => void;
+    signal?: AbortSignal;
+}
+
 /**
  * Built-in HTTP data source with SSE streaming and AbortController
  * Implements ChatDataSource interface with real HTTP/RPC calls
@@ -3204,6 +3342,21 @@ declare class HttpDataSource implements ChatDataSource {
     stopGeneration(sessionId: string): Promise<void>;
     getStreamStatus(sessionId: string): Promise<StreamStatus | null>;
     resumeStream(sessionId: string, runId: string, onChunk: (chunk: StreamChunk) => void, signal?: AbortSignal): Promise<void>;
+    /**
+     * Open a native EventSource against GET /stream/events for the given
+     * run. Used by components that want browser-native auto-reconnect
+     * with Last-Event-ID (tab close, wifi drop, device switch). Prefer
+     * over resumeStream when tailing an already-running generation that
+     * another tab started.
+     */
+    subscribeRunEvents(sessionId: string, runId: string, options: SubscribeRunEventsOptions): Promise<void>;
+    /**
+     * Subscribe to the per-tenant active-run fan-out
+     * (GET /stream/active-runs). Never resolves until the caller aborts
+     * via the signal; use from a top-level component (sidebar container)
+     * that mounts for the lifetime of the chat app.
+     */
+    subscribeActiveRuns(options: SubscribeActiveRunsOptions): Promise<void>;
     sendMessage(sessionId: string, content: string, attachments?: Attachment$1[], signal?: AbortSignal, options?: SendMessageOptions): AsyncGenerator<StreamChunk>;
     cancelStream(): void;
     submitQuestionAnswers(sessionId: string, questionId: string, answers: QuestionAnswers): Promise<{
@@ -4259,4 +4412,76 @@ declare function isPermissionDeniedError(error: unknown): boolean;
  */
 declare function toErrorDisplay(error: unknown, fallbackTitle: string): RPCErrorDisplay;
 
-export { ATTACHMENT_ACCEPT_ATTRIBUTE, ActionButton, type ActionButtonIconProps, type ActionButtonLabelProps, type ActionButtonRootProps, type ActionButtonTooltipProps, type ActiveTab, type ActivityStep, ActivityTrace, type ActivityTraceProps, type AdminStore, _default$1 as Alert, AllChatsList, type AppConfig, _default as ArchiveBanner, ArchivedChatList, type Artifact$1 as Artifact, type ArtifactStore, type AsChildProps, AssistantMessage, type AssistantMessageActionsSlotProps, type AssistantMessageArtifactsSlotProps, type AssistantMessageAvatarSlotProps, type AssistantMessageChartsSlotProps, type AssistantMessageClassNames, type AssistantMessageCodeOutputsSlotProps, type AssistantMessageContentSlotProps, type AssistantMessageExplanationSlotProps, type AssistantMessageProps, type AssistantMessageSlots, type AssistantMessageSourcesSlotProps, type AssistantMessageTablesSlotProps, type AssistantTurn$1 as AssistantTurn, AssistantTurnView, type AssistantTurnViewProps, type Attachment$1 as Attachment, MemoizedAttachmentGrid as AttachmentGrid, AttachmentPreview, AttachmentUpload, Avatar, type AvatarFallbackProps, type AvatarImageProps, type AvatarRootProps, AvatarStack, type AvatarStackProps, type BiChatConfig, BiChatLayout, type BiChatLayoutProps, type BichatRPC, Bubble, type BubbleContentProps, type BubbleFooterProps, type BubbleHeaderProps, type BubbleMetadataProps, type BubbleRootProps, type BubbleVariant, CHART_VISUAL, ChartCard, type ChartCardHost, type ChartData, type ChartSeries, type ChatDataSource, ChatHeader, type ChatInputStateValue, ChatMachine, type ChatMachineConfig, type ChatMessagingStateValue, ChatSession, type ChatSessionContextValue, type ChatSessionProps, ChatSessionProvider, type ChatSessionProviderProps, type ChatSessionStateValue, type Citation$1 as Citation, MemoizedCodeBlock as CodeBlock, type CodeOutput$1 as CodeOutput, CodeOutputsPanel, type ColumnMeta, type ColumnStats, type ColumnType, CompactionDoodle, ConfigProvider, ConfirmModal, type ConfirmModalProps, ConfirmationStep, type ConversationTurn$1 as ConversationTurn, type DataTableOptions, DateGroupHeader, DebugPanel, type DebugPanelProps, DefaultErrorContent, DownloadCard, MemoizedEditableText as EditableText, type EditableTextProps, type EditableTextRef, MemoizedEmptyState as EmptyState, type EmptyStateProps, ErrorBoundary, type FileValidationError, type FileVisual, type FormattedCell, HttpDataSource, type HttpDataSourceConfig, type ImageAttachment, type ImageLoadingStatus, ImageModal, InlineQuestionForm, InteractiveTableCard, type IotaContext, IotaContextProvider, ListItemSkeleton, MemoizedLoadingSpinner as LoadingSpinner, type LocaleContext, MemoizedMarkdownRenderer as MarkdownRenderer, MessageActions, MessageInput, type MessageInputProps, type MessageInputRef, MessageList, MessageRole, type MessageTransport, ModelSelector, type PendingQuestion$1 as PendingQuestion, PermissionGuard, type PermissionGuardProps, type Question, type QuestionAnswerData, type QuestionAnswers, QuestionForm, type QuestionOption, QuestionStep, type QueuedMessage, type RPCErrorDisplay, RateLimiter, type RateLimiterConfig, type RenderTableData, type RenderTableExport, RetryActionArea, ScreenReaderAnnouncer, ScrollToBottomButton, MemoizedSearchInput as SearchInput, type SearchInputProps, type Session$1 as Session, type SessionAccess$1 as SessionAccess, type SessionArtifact, SessionArtifactList, SessionArtifactPreview, SessionArtifactsPanel, type SessionGroup, SessionItem, type SessionListResult$1 as SessionListResult, type SessionMember$1 as SessionMember, SessionMembersModal, type SessionMembersModalProps, SessionSkeleton, type SessionStore, type SessionUser$1 as SessionUser, type ShortcutConfig, Sidebar, type SidebarDrawerProps, type SidebarProps, MemoizedSkeleton as Skeleton, SkeletonAvatar, SkeletonCard, SkeletonGroup, type SkeletonGroupProps, type SkeletonProps, SkeletonText, SkipLink, Slot, type SlotProps, type SortState, SourcesPanel, type StreamChunk, StreamError, type StreamEvent, StreamingCursor, SystemMessage, TabbedChartGroup, type TabbedChartGroupProps, TabbedTableGroup, type TabbedTableGroupProps, type TableCardHost, TableExportButton, TableWithExport, type TenantContext, type Theme, type ThemeBorderRadius, type ThemeColors, ThemeProvider, type ThemeSpacing, Toast, type ToastAction, ToastContainer, type ToastItem, type ToastProps, type ToastType, type ToolCall$1 as ToolCall, TouchContextMenu, Turn, type TurnActionsProps, type TurnAssistantProps, TurnBubble, type TurnBubbleClassNames, type TurnBubbleProps, type TurnRootProps, type TurnTimestampProps, type TurnUserProps, MemoizedTypingIndicator as TypingIndicator, type TypingIndicatorProps, type UseAttachmentsOptions, type UseAttachmentsReturn, type UseAutoScrollOptions, type UseAutoScrollReturn, type UseBichatRouterParams, type UseBichatRouterReturn, type UseDataTableReturn, type UseImageGalleryOptions, type UseImageGalleryReturn, type UseMarkdownCopyOptions, type UseMarkdownCopyReturn, type UseMessageActionsOptions, type UseMessageActionsReturn, type UseSidebarStateReturn, type UseToastReturn, MemoizedUserAvatar as UserAvatar, type UserAvatarProps, type UserContext, MemoizedUserFilter as UserFilter, UserMessage, type UserMessageActionsSlotProps, type UserMessageAttachmentsSlotProps, type UserMessageAvatarSlotProps, type UserMessageClassNames, type UserMessageContentSlotProps, type UserMessageProps, type UserMessageSlots, type UserTurn$1 as UserTurn, UserTurnView, type UserTurnViewProps, WelcomeContent, addCSRFHeader, backdropVariants, buttonVariants, convertToBase64, createDataUrl, createHeadersWithCSRF, createHttpDataSource, darkTheme, dropdownVariants, errorMessageVariants, fadeInUpVariants, fadeInVariants, floatingButtonVariants, formatFileSize, getCSRFToken, getFileVisual, getToolLabel, getValidChildren, groupSessionsByDate, groupSteps, hasPermission, isImageMimeType, isPermissionDeniedError, lightTheme, listItemVariants, messageContainerVariants, messageVariants, parseBichatStream, parseBichatStreamEvents, parseSSEStream, scaleFadeVariants, sessionItemVariants, staggerContainerVariants, toErrorDisplay, typingDotVariants, useActionButtonContext, useAttachments, useAutoScroll, useAvatarContext, useBichatRouter, useBubbleContext, useChatInput, useChatMessaging, useChatSession, useConfig, useDataTable, useFocusTrap, useHttpDataSourceConfigFromApplet, useImageGallery, useIotaContext, useKeyboardShortcuts, useLongPress, useMarkdownCopy, useMessageActions, useModalLock, useOptionalChatMessaging, useRequiredConfig, useScrollToBottom, useSidebarState, useStreaming, useTheme, useToast, useTranslation, useTurnContext, validateAttachmentFile, validateFileCount, validateImageFile, verbTransitionVariants };
+/**
+ * Utilities for splitting accumulated assistant content into the distinct
+ * text blocks the server emitted.
+ *
+ * Background: the executor interleaves text with tool calls within one
+ * turn — `text → tool_call → text → tool_call → final_text`. Before the
+ * backend emitted `text_block_end` markers (iota-uz/iota-sdk#732 M1),
+ * all text segments collapsed into one paragraph on the client. Now the
+ * server emits a `text_block_end` event before each tool_start and at
+ * snapshot time carries byte offsets in `partialMetadata.text_block_offsets`.
+ *
+ * `splitIntoTextBlocks` is the client-side inverse: given the
+ * accumulated content string and the ordered list of byte offsets that
+ * mark segment ends, return one entry per segment. The trailing un-closed
+ * segment (if any) is included as the last entry.
+ */
+interface AssistantTextBlock {
+    /** Zero-based index matching the seq carried on text_block_end events. */
+    seq: number;
+    /** Markdown source for this segment. */
+    content: string;
+}
+/**
+ * Split an accumulated assistant content string into blocks using byte
+ * offsets emitted by the server. Offsets are EXCLUSIVE end markers —
+ * i.e. `offsets[0]` is the length of block 0.
+ *
+ * - When `offsets` is empty or undefined, returns a single block with
+ *   the full content.
+ * - When offsets are provided but content is shorter than the last
+ *   offset (e.g. stale metadata), offsets beyond the content length are
+ *   clamped so no crash propagates up.
+ * - Trailing content after the last offset is included as an extra
+ *   block (the un-closed segment during streaming / the final segment
+ *   after the last tool call).
+ */
+declare function splitIntoTextBlocks(content: string, offsets?: ReadonlyArray<number> | null): AssistantTextBlock[];
+/**
+ * Normalise partialMetadata.text_block_offsets from a StreamSnapshotPayload
+ * into a number[]. Guards against malformed server data (non-array,
+ * non-numeric entries) so UI code never has to think about shapes.
+ */
+declare function readTextBlockOffsets(partialMetadata?: Record<string, unknown> | null): number[];
+
+/**
+ * Hand-mirrored copy of the backend's pkg/httpdto.StreamEventType
+ * constant set. Used by subscribeRunEvents / subscribeActiveRuns /
+ * openManagedEventSource to register addEventListener handlers that
+ * match every `event:` label the server emits.
+ *
+ * Drift between this file and the Go definition is caught by
+ * eventNames.test.ts — the test reads the sibling Go source at test
+ * time and diffs the constant set. When the Go file is absent (CI
+ * without the SDK sidecar checkout) the drift guard self-skips.
+ */
+declare const STREAM_EVENT_TYPES: readonly ["chunk", "content", "thinking", "tool_start", "tool_end", "text_block_end", "snapshot", "interrupt", "citation", "usage", "ping", "stream_started", "done", "cancelled", "error", "failed"];
+type StreamEventType = typeof STREAM_EVENT_TYPES[number];
+/**
+ * Subset of {@link STREAM_EVENT_TYPES} that terminates a run from the
+ * client's perspective. Callers should close the EventSource and
+ * settle their promise on any of these.
+ */
+declare const TERMINAL_STREAM_EVENT_TYPES: readonly ["done", "cancelled", "error", "failed"];
+type TerminalStreamEventType = typeof TERMINAL_STREAM_EVENT_TYPES[number];
+/**
+ * Narrow + type-guard helper. Returns true when `name` is one of the
+ * terminal stream event types. The guard narrows precisely to the
+ * terminal subset — callers receiving `true` get {@link TerminalStreamEventType},
+ * not the full {@link StreamEventType} union.
+ */
+declare function isTerminalEvent(name: string): name is TerminalStreamEventType;
+
+export { ATTACHMENT_ACCEPT_ATTRIBUTE, ActionButton, type ActionButtonIconProps, type ActionButtonLabelProps, type ActionButtonRootProps, type ActionButtonTooltipProps, type ActiveRunDelivery, type ActiveRunSnapshot, type ActiveTab, type ActivityStep, ActivityTrace, type ActivityTraceProps, type AdminStore, _default$1 as Alert, AllChatsList, type AppConfig, _default as ArchiveBanner, ArchivedChatList, type Artifact$1 as Artifact, type ArtifactStore, type AsChildProps, AssistantMessage, type AssistantMessageActionsSlotProps, type AssistantMessageArtifactsSlotProps, type AssistantMessageAvatarSlotProps, type AssistantMessageChartsSlotProps, type AssistantMessageClassNames, type AssistantMessageCodeOutputsSlotProps, type AssistantMessageContentSlotProps, type AssistantMessageExplanationSlotProps, type AssistantMessageProps, type AssistantMessageSlots, type AssistantMessageSourcesSlotProps, type AssistantMessageTablesSlotProps, type AssistantTextBlock, type AssistantTurn$1 as AssistantTurn, AssistantTurnView, type AssistantTurnViewProps, type Attachment$1 as Attachment, MemoizedAttachmentGrid as AttachmentGrid, AttachmentPreview, AttachmentUpload, Avatar, type AvatarFallbackProps, type AvatarImageProps, type AvatarRootProps, AvatarStack, type AvatarStackProps, type BiChatConfig, BiChatLayout, type BiChatLayoutProps, type BichatRPC, Bubble, type BubbleContentProps, type BubbleFooterProps, type BubbleHeaderProps, type BubbleMetadataProps, type BubbleRootProps, type BubbleVariant, CHART_VISUAL, ChartCard, type ChartCardHost, type ChartData, type ChartSeries, type ChatDataSource, ChatHeader, type ChatInputStateValue, ChatMachine, type ChatMachineConfig, type ChatMessagingStateValue, ChatSession, type ChatSessionContextValue, type ChatSessionProps, ChatSessionProvider, type ChatSessionProviderProps, type ChatSessionStateValue, type Citation$1 as Citation, MemoizedCodeBlock as CodeBlock, type CodeOutput$1 as CodeOutput, CodeOutputsPanel, type ColumnMeta, type ColumnStats, type ColumnType, CompactionDoodle, ConfigProvider, ConfirmModal, type ConfirmModalProps, ConfirmationStep, type ConversationTurn$1 as ConversationTurn, type DataTableOptions, DateGroupHeader, DebugPanel, type DebugPanelProps, DefaultErrorContent, DownloadCard, MemoizedEditableText as EditableText, type EditableTextProps, type EditableTextRef, MemoizedEmptyState as EmptyState, type EmptyStateProps, ErrorBoundary, type FileValidationError, type FileVisual, type FormattedCell, HttpDataSource, type HttpDataSourceConfig, type ImageAttachment, type ImageLoadingStatus, ImageModal, InlineQuestionForm, InteractiveTableCard, type IotaContext, IotaContextProvider, ListItemSkeleton, MemoizedLoadingSpinner as LoadingSpinner, type LocaleContext, MemoizedMarkdownRenderer as MarkdownRenderer, MessageActions, MessageInput, type MessageInputProps, type MessageInputRef, MessageList, MessageRole, type MessageTransport, ModelSelector, type PendingQuestion$1 as PendingQuestion, PermissionGuard, type PermissionGuardProps, type Question, type QuestionAnswerData, type QuestionAnswers, QuestionForm, type QuestionOption, QuestionStep, type QueuedMessage, type RPCErrorDisplay, RateLimiter, type RateLimiterConfig, type RenderTableData, type RenderTableExport, RetryActionArea, RunEventsConnectError, STREAM_EVENT_TYPES, ScreenReaderAnnouncer, ScrollToBottomButton, MemoizedSearchInput as SearchInput, type SearchInputProps, type Session$1 as Session, type SessionAccess$1 as SessionAccess, type SessionArtifact, SessionArtifactList, SessionArtifactPreview, SessionArtifactsPanel, type SessionGroup, SessionItem, type SessionListResult$1 as SessionListResult, type SessionMember$1 as SessionMember, SessionMembersModal, type SessionMembersModalProps, SessionSkeleton, type SessionStore, type SessionUser$1 as SessionUser, type ShortcutConfig, Sidebar, type SidebarDrawerProps, type SidebarProps, MemoizedSkeleton as Skeleton, SkeletonAvatar, SkeletonCard, SkeletonGroup, type SkeletonGroupProps, type SkeletonProps, SkeletonText, SkipLink, Slot, type SlotProps, type SortState, SourcesPanel, type StreamChunk, StreamError, type StreamEvent, type StreamEventType, StreamingCursor, SystemMessage, TERMINAL_STREAM_EVENT_TYPES, TabbedChartGroup, type TabbedChartGroupProps, TabbedTableGroup, type TabbedTableGroupProps, type TableCardHost, TableExportButton, TableWithExport, type TenantContext, type TerminalStreamEventType, type Theme, type ThemeBorderRadius, type ThemeColors, ThemeProvider, type ThemeSpacing, Toast, type ToastAction, ToastContainer, type ToastItem, type ToastProps, type ToastType, type ToolCall$1 as ToolCall, TouchContextMenu, Turn, type TurnActionsProps, type TurnAssistantProps, TurnBubble, type TurnBubbleClassNames, type TurnBubbleProps, type TurnRootProps, type TurnTimestampProps, type TurnUserProps, MemoizedTypingIndicator as TypingIndicator, type TypingIndicatorProps, type UseActiveRunsOptions, type UseActiveRunsResult, type UseAttachmentsOptions, type UseAttachmentsReturn, type UseAutoScrollOptions, type UseAutoScrollReturn, type UseBichatRouterParams, type UseBichatRouterReturn, type UseDataTableReturn, type UseImageGalleryOptions, type UseImageGalleryReturn, type UseMarkdownCopyOptions, type UseMarkdownCopyReturn, type UseMessageActionsOptions, type UseMessageActionsReturn, type UseSidebarStateReturn, type UseToastReturn, MemoizedUserAvatar as UserAvatar, type UserAvatarProps, type UserContext, MemoizedUserFilter as UserFilter, UserMessage, type UserMessageActionsSlotProps, type UserMessageAttachmentsSlotProps, type UserMessageAvatarSlotProps, type UserMessageClassNames, type UserMessageContentSlotProps, type UserMessageProps, type UserMessageSlots, type UserTurn$1 as UserTurn, UserTurnView, type UserTurnViewProps, WelcomeContent, addCSRFHeader, backdropVariants, buttonVariants, convertToBase64, createDataUrl, createHeadersWithCSRF, createHttpDataSource, darkTheme, dropdownVariants, errorMessageVariants, fadeInUpVariants, fadeInVariants, floatingButtonVariants, formatFileSize, getCSRFToken, getFileVisual, getToolLabel, getValidChildren, groupSessionsByDate, groupSteps, hasPermission, isImageMimeType, isPermissionDeniedError, isTerminalEvent, lightTheme, listItemVariants, messageContainerVariants, messageVariants, parseBichatStream, parseBichatStreamEvents, parseSSEStream, readTextBlockOffsets, scaleFadeVariants, sessionItemVariants, splitIntoTextBlocks, staggerContainerVariants, toErrorDisplay, typingDotVariants, useActionButtonContext, useActiveRuns, useAttachments, useAutoScroll, useAvatarContext, useBichatRouter, useBubbleContext, useChatInput, useChatMessaging, useChatSession, useConfig, useDataTable, useFocusTrap, useHttpDataSourceConfigFromApplet, useImageGallery, useIotaContext, useKeyboardShortcuts, useLongPress, useMarkdownCopy, useMessageActions, useModalLock, useOptionalChatMessaging, useRequiredConfig, useScrollToBottom, useSidebarState, useStreaming, useTheme, useToast, useTranslation, useTurnContext, validateAttachmentFile, validateFileCount, validateImageFile, verbTransitionVariants };

package/dist/bichat/index.d.ts

@@ -370,6 +370,9 @@ type StreamEvent = {
     type: "interrupt";
     interrupt: StreamInterruptPayload;
     sessionId?: string;
+} | {
+    type: "text_block_end";
+    seq: number;
 } | {
     type: "done";
     sessionId?: string;
@@ -402,7 +405,7 @@ interface AsyncRunAccepted {
  * compatibility but the flat all-optional shape is unsound.
  */
 interface StreamChunk {
-    type: "chunk" | "content" | "thinking" | "tool_start" | "tool_end" | "usage" | "done" | "error" | "user_message" | "interrupt" | "snapshot" | "stream_started";
+    type: "chunk" | "content" | "thinking" | "tool_start" | "tool_end" | "usage" | "done" | "error" | "user_message" | "interrupt" | "snapshot" | "stream_started" | "text_block_end";
     content?: string;
     error?: string;
     sessionId?: string;
@@ -414,6 +417,27 @@ interface StreamChunk {
     snapshot?: StreamSnapshotPayload;
     /** Set when type is 'stream_started'; client should store for refresh-safe resume */
     runId?: string;
+    /**
+     * Zero-based ordinal of the assistant text segment that just ended.
+     * Populated only when type === "text_block_end". Used to split the
+     * accumulated assistant content into distinct blocks interleaved with
+     * tool_call UI (text → tool → text → tool → final_text).
+     */
+    textBlockSeq?: number;
+}
+/**
+ * Per-tenant active-run status event. Delivered via the
+ * GET /bi-chat/stream/active-runs SSE endpoint. The first batch after
+ * connect carries `event === "snapshot"` for each currently-running
+ * session; subsequent rows carry `event === "update"` as runs
+ * transition (queued → streaming → completed / cancelled / failed).
+ */
+interface ActiveRunDelivery {
+    event: "snapshot" | "update";
+    sessionId: string;
+    runId: string;
+    status: "queued" | "streaming" | "completed" | "cancelled" | "failed";
+    updatedAt: number;
 }
 interface StreamInterruptPayload {
     checkpointId: string;
@@ -531,6 +555,13 @@ interface SendMessageOptions {
     replaceFromMessageID?: string;
     reasoningEffort?: string;
     model?: string;
+    /**
+     * Client-generated idempotency key. Duplicate sends sharing the same
+     * requestId within the backend's dedupe window (~30 min) converge on
+     * a single server-side run. Omit to disable dedupe for a particular
+     * send; the data source auto-generates one per call otherwise.
+     */
+    requestId?: string;
 }
 interface SessionListResult$1 {
     sessions: Session$1[];
@@ -617,6 +648,32 @@ interface ChatDataSource {
      * Optional; if absent, resume is not supported.
      */
     resumeStream?(sessionId: string, runId: string, onChunk: (chunk: StreamChunk) => void, signal?: AbortSignal): Promise<void>;
+    /**
+     * Tail a run via native EventSource against GET /stream/events. Honours
+     * Last-Event-ID for auto-reconnect on wifi drops / tab sleep. Prefer
+     * over resumeStream when connecting to a run that was started by
+     * another tab (same request_id) or that needs to survive a reload
+     * via cursor-based replay. Optional; data sources that don't
+     * implement it fall back to resumeStream.
+     */
+    subscribeRunEvents?(sessionId: string, runId: string, options: {
+        lastEventId?: string;
+        onChunk: (chunk: StreamChunk) => void;
+        onError?: (event: Event) => void;
+        signal?: AbortSignal;
+    }): Promise<void>;
+    /**
+     * Subscribe to the per-tenant active-run fan-out
+     * (GET /stream/active-runs). Emits one "snapshot" event per
+     * currently-running session on connect, then live "update" deltas.
+     * Optional; data sources that don't implement it fall back to
+     * per-session polling via getStreamStatus.
+     */
+    subscribeActiveRuns?(options: {
+        onEvent: (event: ActiveRunDelivery) => void;
+        onError?: (event: Event) => void;
+        signal?: AbortSignal;
+    }): Promise<void>;
     listSessions(options?: {
         limit?: number;
         offset?: number;
@@ -2293,6 +2350,54 @@ declare function useStreaming(options?: UseStreamingOptions): {
     reset: () => void;
 };
 
+/**
+ * useActiveRuns — live map of per-session generation status.
+ *
+ * Subscribes to the data source's `subscribeActiveRuns` channel
+ * (`GET /bi-chat/stream/active-runs`) and maintains a
+ * sessionId → status dictionary so the sidebar can render a status
+ * dot next to each session card without polling /stream/status per
+ * session.
+ *
+ * The hook is a no-op when:
+ * - the data source does not implement subscribeActiveRuns (older
+ *   backends without the active-run index);
+ * - `enabled` is false (e.g. the user is offline).
+ */
+
+interface ActiveRunSnapshot {
+    runId: string;
+    status: ActiveRunDelivery['status'];
+    updatedAt: number;
+}
+interface UseActiveRunsOptions {
+    enabled?: boolean;
+    /** Optional hook for raw SSE errors. */
+    onError?: (event: Event) => void;
+    /**
+     * Keep terminal-status entries in the map for this many milliseconds
+     * before pruning them. Default 0 preserves the previous behaviour
+     * (synchronous delete). Useful when consumers want to render a
+     * "completed" pulse animation before the dot disappears.
+     */
+    retainTerminalMs?: number;
+    /**
+     * How long to wait for an initial snapshot batch before declaring
+     * the hook `ready` when the server has zero active runs.
+     * Default 250ms.
+     */
+    emptyStateTimeoutMs?: number;
+}
+interface UseActiveRunsResult {
+    /** sessionId → current live status. Terminal statuses are emitted then the entry is removed. */
+    runs: Record<string, ActiveRunSnapshot>;
+    /** True once the initial HGETALL snapshot is delivered. */
+    ready: boolean;
+    /** Convenience: undefined when not active. */
+    status: (sessionId: string) => ActiveRunDelivery['status'] | undefined;
+}
+declare function useActiveRuns(dataSource: Pick<ChatDataSource, 'subscribeActiveRuns'>, options?: UseActiveRunsOptions): UseActiveRunsResult;
+
 /**
  * Translation hook using locale from IotaContext
  */
@@ -3131,6 +3236,39 @@ interface SessionState {
     pendingQuestion?: PendingQuestion$1 | null;
 }
 
+/**
+ * Message sending, SSE streaming, and HITL question handling.
+ *
+ * @internal — Not part of the public API. Consumed by HttpDataSource.
+ */
+
+/**
+ * Thrown by {@link subscribeRunEvents} when the underlying EventSource
+ * emits `onerror` before the first event arrives within the
+ * initial-connect grace window. Distinguishes boundary failures
+ * (401 / 404 / 503) from transient mid-run flaps, which the browser's
+ * native auto-reconnect continues to handle silently.
+ */
+declare class RunEventsConnectError extends Error {
+    readonly cause?: Event;
+    constructor(message: string, cause?: Event);
+}
+interface SubscribeRunEventsOptions {
+    /** When set, start from the last seen event id instead of a full replay. */
+    lastEventId?: string;
+    /** Fires for every chunk (content / tool / snapshot / done / error / …). */
+    onChunk: (chunk: StreamChunk) => void;
+    /** Optional hook for raw SSE errors (connection blips, parse failures). */
+    onError?: (event: Event) => void;
+    /** AbortSignal closes the underlying EventSource. */
+    signal?: AbortSignal;
+}
+interface SubscribeActiveRunsOptions {
+    onEvent: (event: ActiveRunDelivery) => void;
+    onError?: (event: Event) => void;
+    signal?: AbortSignal;
+}
+
 /**
  * Built-in HTTP data source with SSE streaming and AbortController
  * Implements ChatDataSource interface with real HTTP/RPC calls
@@ -3204,6 +3342,21 @@ declare class HttpDataSource implements ChatDataSource {
     stopGeneration(sessionId: string): Promise<void>;
     getStreamStatus(sessionId: string): Promise<StreamStatus | null>;
     resumeStream(sessionId: string, runId: string, onChunk: (chunk: StreamChunk) => void, signal?: AbortSignal): Promise<void>;
+    /**
+     * Open a native EventSource against GET /stream/events for the given
+     * run. Used by components that want browser-native auto-reconnect
+     * with Last-Event-ID (tab close, wifi drop, device switch). Prefer
+     * over resumeStream when tailing an already-running generation that
+     * another tab started.
+     */
+    subscribeRunEvents(sessionId: string, runId: string, options: SubscribeRunEventsOptions): Promise<void>;
+    /**
+     * Subscribe to the per-tenant active-run fan-out
+     * (GET /stream/active-runs). Never resolves until the caller aborts
+     * via the signal; use from a top-level component (sidebar container)
+     * that mounts for the lifetime of the chat app.
+     */
+    subscribeActiveRuns(options: SubscribeActiveRunsOptions): Promise<void>;
     sendMessage(sessionId: string, content: string, attachments?: Attachment$1[], signal?: AbortSignal, options?: SendMessageOptions): AsyncGenerator<StreamChunk>;
     cancelStream(): void;
     submitQuestionAnswers(sessionId: string, questionId: string, answers: QuestionAnswers): Promise<{
@@ -4259,4 +4412,76 @@ declare function isPermissionDeniedError(error: unknown): boolean;
  */
 declare function toErrorDisplay(error: unknown, fallbackTitle: string): RPCErrorDisplay;
 
-export { ATTACHMENT_ACCEPT_ATTRIBUTE, ActionButton, type ActionButtonIconProps, type ActionButtonLabelProps, type ActionButtonRootProps, type ActionButtonTooltipProps, type ActiveTab, type ActivityStep, ActivityTrace, type ActivityTraceProps, type AdminStore, _default$1 as Alert, AllChatsList, type AppConfig, _default as ArchiveBanner, ArchivedChatList, type Artifact$1 as Artifact, type ArtifactStore, type AsChildProps, AssistantMessage, type AssistantMessageActionsSlotProps, type AssistantMessageArtifactsSlotProps, type AssistantMessageAvatarSlotProps, type AssistantMessageChartsSlotProps, type AssistantMessageClassNames, type AssistantMessageCodeOutputsSlotProps, type AssistantMessageContentSlotProps, type AssistantMessageExplanationSlotProps, type AssistantMessageProps, type AssistantMessageSlots, type AssistantMessageSourcesSlotProps, type AssistantMessageTablesSlotProps, type AssistantTurn$1 as AssistantTurn, AssistantTurnView, type AssistantTurnViewProps, type Attachment$1 as Attachment, MemoizedAttachmentGrid as AttachmentGrid, AttachmentPreview, AttachmentUpload, Avatar, type AvatarFallbackProps, type AvatarImageProps, type AvatarRootProps, AvatarStack, type AvatarStackProps, type BiChatConfig, BiChatLayout, type BiChatLayoutProps, type BichatRPC, Bubble, type BubbleContentProps, type BubbleFooterProps, type BubbleHeaderProps, type BubbleMetadataProps, type BubbleRootProps, type BubbleVariant, CHART_VISUAL, ChartCard, type ChartCardHost, type ChartData, type ChartSeries, type ChatDataSource, ChatHeader, type ChatInputStateValue, ChatMachine, type ChatMachineConfig, type ChatMessagingStateValue, ChatSession, type ChatSessionContextValue, type ChatSessionProps, ChatSessionProvider, type ChatSessionProviderProps, type ChatSessionStateValue, type Citation$1 as Citation, MemoizedCodeBlock as CodeBlock, type CodeOutput$1 as CodeOutput, CodeOutputsPanel, type ColumnMeta, type ColumnStats, type ColumnType, CompactionDoodle, ConfigProvider, ConfirmModal, type ConfirmModalProps, ConfirmationStep, type ConversationTurn$1 as ConversationTurn, type DataTableOptions, DateGroupHeader, DebugPanel, type DebugPanelProps, DefaultErrorContent, DownloadCard, MemoizedEditableText as EditableText, type EditableTextProps, type EditableTextRef, MemoizedEmptyState as EmptyState, type EmptyStateProps, ErrorBoundary, type FileValidationError, type FileVisual, type FormattedCell, HttpDataSource, type HttpDataSourceConfig, type ImageAttachment, type ImageLoadingStatus, ImageModal, InlineQuestionForm, InteractiveTableCard, type IotaContext, IotaContextProvider, ListItemSkeleton, MemoizedLoadingSpinner as LoadingSpinner, type LocaleContext, MemoizedMarkdownRenderer as MarkdownRenderer, MessageActions, MessageInput, type MessageInputProps, type MessageInputRef, MessageList, MessageRole, type MessageTransport, ModelSelector, type PendingQuestion$1 as PendingQuestion, PermissionGuard, type PermissionGuardProps, type Question, type QuestionAnswerData, type QuestionAnswers, QuestionForm, type QuestionOption, QuestionStep, type QueuedMessage, type RPCErrorDisplay, RateLimiter, type RateLimiterConfig, type RenderTableData, type RenderTableExport, RetryActionArea, ScreenReaderAnnouncer, ScrollToBottomButton, MemoizedSearchInput as SearchInput, type SearchInputProps, type Session$1 as Session, type SessionAccess$1 as SessionAccess, type SessionArtifact, SessionArtifactList, SessionArtifactPreview, SessionArtifactsPanel, type SessionGroup, SessionItem, type SessionListResult$1 as SessionListResult, type SessionMember$1 as SessionMember, SessionMembersModal, type SessionMembersModalProps, SessionSkeleton, type SessionStore, type SessionUser$1 as SessionUser, type ShortcutConfig, Sidebar, type SidebarDrawerProps, type SidebarProps, MemoizedSkeleton as Skeleton, SkeletonAvatar, SkeletonCard, SkeletonGroup, type SkeletonGroupProps, type SkeletonProps, SkeletonText, SkipLink, Slot, type SlotProps, type SortState, SourcesPanel, type StreamChunk, StreamError, type StreamEvent, StreamingCursor, SystemMessage, TabbedChartGroup, type TabbedChartGroupProps, TabbedTableGroup, type TabbedTableGroupProps, type TableCardHost, TableExportButton, TableWithExport, type TenantContext, type Theme, type ThemeBorderRadius, type ThemeColors, ThemeProvider, type ThemeSpacing, Toast, type ToastAction, ToastContainer, type ToastItem, type ToastProps, type ToastType, type ToolCall$1 as ToolCall, TouchContextMenu, Turn, type TurnActionsProps, type TurnAssistantProps, TurnBubble, type TurnBubbleClassNames, type TurnBubbleProps, type TurnRootProps, type TurnTimestampProps, type TurnUserProps, MemoizedTypingIndicator as TypingIndicator, type TypingIndicatorProps, type UseAttachmentsOptions, type UseAttachmentsReturn, type UseAutoScrollOptions, type UseAutoScrollReturn, type UseBichatRouterParams, type UseBichatRouterReturn, type UseDataTableReturn, type UseImageGalleryOptions, type UseImageGalleryReturn, type UseMarkdownCopyOptions, type UseMarkdownCopyReturn, type UseMessageActionsOptions, type UseMessageActionsReturn, type UseSidebarStateReturn, type UseToastReturn, MemoizedUserAvatar as UserAvatar, type UserAvatarProps, type UserContext, MemoizedUserFilter as UserFilter, UserMessage, type UserMessageActionsSlotProps, type UserMessageAttachmentsSlotProps, type UserMessageAvatarSlotProps, type UserMessageClassNames, type UserMessageContentSlotProps, type UserMessageProps, type UserMessageSlots, type UserTurn$1 as UserTurn, UserTurnView, type UserTurnViewProps, WelcomeContent, addCSRFHeader, backdropVariants, buttonVariants, convertToBase64, createDataUrl, createHeadersWithCSRF, createHttpDataSource, darkTheme, dropdownVariants, errorMessageVariants, fadeInUpVariants, fadeInVariants, floatingButtonVariants, formatFileSize, getCSRFToken, getFileVisual, getToolLabel, getValidChildren, groupSessionsByDate, groupSteps, hasPermission, isImageMimeType, isPermissionDeniedError, lightTheme, listItemVariants, messageContainerVariants, messageVariants, parseBichatStream, parseBichatStreamEvents, parseSSEStream, scaleFadeVariants, sessionItemVariants, staggerContainerVariants, toErrorDisplay, typingDotVariants, useActionButtonContext, useAttachments, useAutoScroll, useAvatarContext, useBichatRouter, useBubbleContext, useChatInput, useChatMessaging, useChatSession, useConfig, useDataTable, useFocusTrap, useHttpDataSourceConfigFromApplet, useImageGallery, useIotaContext, useKeyboardShortcuts, useLongPress, useMarkdownCopy, useMessageActions, useModalLock, useOptionalChatMessaging, useRequiredConfig, useScrollToBottom, useSidebarState, useStreaming, useTheme, useToast, useTranslation, useTurnContext, validateAttachmentFile, validateFileCount, validateImageFile, verbTransitionVariants };
+/**
+ * Utilities for splitting accumulated assistant content into the distinct
+ * text blocks the server emitted.
+ *
+ * Background: the executor interleaves text with tool calls within one
+ * turn — `text → tool_call → text → tool_call → final_text`. Before the
+ * backend emitted `text_block_end` markers (iota-uz/iota-sdk#732 M1),
+ * all text segments collapsed into one paragraph on the client. Now the
+ * server emits a `text_block_end` event before each tool_start and at
+ * snapshot time carries byte offsets in `partialMetadata.text_block_offsets`.
+ *
+ * `splitIntoTextBlocks` is the client-side inverse: given the
+ * accumulated content string and the ordered list of byte offsets that
+ * mark segment ends, return one entry per segment. The trailing un-closed
+ * segment (if any) is included as the last entry.
+ */
+interface AssistantTextBlock {
+    /** Zero-based index matching the seq carried on text_block_end events. */
+    seq: number;
+    /** Markdown source for this segment. */
+    content: string;
+}
+/**
+ * Split an accumulated assistant content string into blocks using byte
+ * offsets emitted by the server. Offsets are EXCLUSIVE end markers —
+ * i.e. `offsets[0]` is the length of block 0.
+ *
+ * - When `offsets` is empty or undefined, returns a single block with
+ *   the full content.
+ * - When offsets are provided but content is shorter than the last
+ *   offset (e.g. stale metadata), offsets beyond the content length are
+ *   clamped so no crash propagates up.
+ * - Trailing content after the last offset is included as an extra
+ *   block (the un-closed segment during streaming / the final segment
+ *   after the last tool call).
+ */
+declare function splitIntoTextBlocks(content: string, offsets?: ReadonlyArray<number> | null): AssistantTextBlock[];
+/**
+ * Normalise partialMetadata.text_block_offsets from a StreamSnapshotPayload
+ * into a number[]. Guards against malformed server data (non-array,
+ * non-numeric entries) so UI code never has to think about shapes.
+ */
+declare function readTextBlockOffsets(partialMetadata?: Record<string, unknown> | null): number[];
+
+/**
+ * Hand-mirrored copy of the backend's pkg/httpdto.StreamEventType
+ * constant set. Used by subscribeRunEvents / subscribeActiveRuns /
+ * openManagedEventSource to register addEventListener handlers that
+ * match every `event:` label the server emits.
+ *
+ * Drift between this file and the Go definition is caught by
+ * eventNames.test.ts — the test reads the sibling Go source at test
+ * time and diffs the constant set. When the Go file is absent (CI
+ * without the SDK sidecar checkout) the drift guard self-skips.
+ */
+declare const STREAM_EVENT_TYPES: readonly ["chunk", "content", "thinking", "tool_start", "tool_end", "text_block_end", "snapshot", "interrupt", "citation", "usage", "ping", "stream_started", "done", "cancelled", "error", "failed"];
+type StreamEventType = typeof STREAM_EVENT_TYPES[number];
+/**
+ * Subset of {@link STREAM_EVENT_TYPES} that terminates a run from the
+ * client's perspective. Callers should close the EventSource and
+ * settle their promise on any of these.
+ */
+declare const TERMINAL_STREAM_EVENT_TYPES: readonly ["done", "cancelled", "error", "failed"];
+type TerminalStreamEventType = typeof TERMINAL_STREAM_EVENT_TYPES[number];
+/**
+ * Narrow + type-guard helper. Returns true when `name` is one of the
+ * terminal stream event types. The guard narrows precisely to the
+ * terminal subset — callers receiving `true` get {@link TerminalStreamEventType},
+ * not the full {@link StreamEventType} union.
+ */
+declare function isTerminalEvent(name: string): name is TerminalStreamEventType;
+
+export { ATTACHMENT_ACCEPT_ATTRIBUTE, ActionButton, type ActionButtonIconProps, type ActionButtonLabelProps, type ActionButtonRootProps, type ActionButtonTooltipProps, type ActiveRunDelivery, type ActiveRunSnapshot, type ActiveTab, type ActivityStep, ActivityTrace, type ActivityTraceProps, type AdminStore, _default$1 as Alert, AllChatsList, type AppConfig, _default as ArchiveBanner, ArchivedChatList, type Artifact$1 as Artifact, type ArtifactStore, type AsChildProps, AssistantMessage, type AssistantMessageActionsSlotProps, type AssistantMessageArtifactsSlotProps, type AssistantMessageAvatarSlotProps, type AssistantMessageChartsSlotProps, type AssistantMessageClassNames, type AssistantMessageCodeOutputsSlotProps, type AssistantMessageContentSlotProps, type AssistantMessageExplanationSlotProps, type AssistantMessageProps, type AssistantMessageSlots, type AssistantMessageSourcesSlotProps, type AssistantMessageTablesSlotProps, type AssistantTextBlock, type AssistantTurn$1 as AssistantTurn, AssistantTurnView, type AssistantTurnViewProps, type Attachment$1 as Attachment, MemoizedAttachmentGrid as AttachmentGrid, AttachmentPreview, AttachmentUpload, Avatar, type AvatarFallbackProps, type AvatarImageProps, type AvatarRootProps, AvatarStack, type AvatarStackProps, type BiChatConfig, BiChatLayout, type BiChatLayoutProps, type BichatRPC, Bubble, type BubbleContentProps, type BubbleFooterProps, type BubbleHeaderProps, type BubbleMetadataProps, type BubbleRootProps, type BubbleVariant, CHART_VISUAL, ChartCard, type ChartCardHost, type ChartData, type ChartSeries, type ChatDataSource, ChatHeader, type ChatInputStateValue, ChatMachine, type ChatMachineConfig, type ChatMessagingStateValue, ChatSession, type ChatSessionContextValue, type ChatSessionProps, ChatSessionProvider, type ChatSessionProviderProps, type ChatSessionStateValue, type Citation$1 as Citation, MemoizedCodeBlock as CodeBlock, type CodeOutput$1 as CodeOutput, CodeOutputsPanel, type ColumnMeta, type ColumnStats, type ColumnType, CompactionDoodle, ConfigProvider, ConfirmModal, type ConfirmModalProps, ConfirmationStep, type ConversationTurn$1 as ConversationTurn, type DataTableOptions, DateGroupHeader, DebugPanel, type DebugPanelProps, DefaultErrorContent, DownloadCard, MemoizedEditableText as EditableText, type EditableTextProps, type EditableTextRef, MemoizedEmptyState as EmptyState, type EmptyStateProps, ErrorBoundary, type FileValidationError, type FileVisual, type FormattedCell, HttpDataSource, type HttpDataSourceConfig, type ImageAttachment, type ImageLoadingStatus, ImageModal, InlineQuestionForm, InteractiveTableCard, type IotaContext, IotaContextProvider, ListItemSkeleton, MemoizedLoadingSpinner as LoadingSpinner, type LocaleContext, MemoizedMarkdownRenderer as MarkdownRenderer, MessageActions, MessageInput, type MessageInputProps, type MessageInputRef, MessageList, MessageRole, type MessageTransport, ModelSelector, type PendingQuestion$1 as PendingQuestion, PermissionGuard, type PermissionGuardProps, type Question, type QuestionAnswerData, type QuestionAnswers, QuestionForm, type QuestionOption, QuestionStep, type QueuedMessage, type RPCErrorDisplay, RateLimiter, type RateLimiterConfig, type RenderTableData, type RenderTableExport, RetryActionArea, RunEventsConnectError, STREAM_EVENT_TYPES, ScreenReaderAnnouncer, ScrollToBottomButton, MemoizedSearchInput as SearchInput, type SearchInputProps, type Session$1 as Session, type SessionAccess$1 as SessionAccess, type SessionArtifact, SessionArtifactList, SessionArtifactPreview, SessionArtifactsPanel, type SessionGroup, SessionItem, type SessionListResult$1 as SessionListResult, type SessionMember$1 as SessionMember, SessionMembersModal, type SessionMembersModalProps, SessionSkeleton, type SessionStore, type SessionUser$1 as SessionUser, type ShortcutConfig, Sidebar, type SidebarDrawerProps, type SidebarProps, MemoizedSkeleton as Skeleton, SkeletonAvatar, SkeletonCard, SkeletonGroup, type SkeletonGroupProps, type SkeletonProps, SkeletonText, SkipLink, Slot, type SlotProps, type SortState, SourcesPanel, type StreamChunk, StreamError, type StreamEvent, type StreamEventType, StreamingCursor, SystemMessage, TERMINAL_STREAM_EVENT_TYPES, TabbedChartGroup, type TabbedChartGroupProps, TabbedTableGroup, type TabbedTableGroupProps, type TableCardHost, TableExportButton, TableWithExport, type TenantContext, type TerminalStreamEventType, type Theme, type ThemeBorderRadius, type ThemeColors, ThemeProvider, type ThemeSpacing, Toast, type ToastAction, ToastContainer, type ToastItem, type ToastProps, type ToastType, type ToolCall$1 as ToolCall, TouchContextMenu, Turn, type TurnActionsProps, type TurnAssistantProps, TurnBubble, type TurnBubbleClassNames, type TurnBubbleProps, type TurnRootProps, type TurnTimestampProps, type TurnUserProps, MemoizedTypingIndicator as TypingIndicator, type TypingIndicatorProps, type UseActiveRunsOptions, type UseActiveRunsResult, type UseAttachmentsOptions, type UseAttachmentsReturn, type UseAutoScrollOptions, type UseAutoScrollReturn, type UseBichatRouterParams, type UseBichatRouterReturn, type UseDataTableReturn, type UseImageGalleryOptions, type UseImageGalleryReturn, type UseMarkdownCopyOptions, type UseMarkdownCopyReturn, type UseMessageActionsOptions, type UseMessageActionsReturn, type UseSidebarStateReturn, type UseToastReturn, MemoizedUserAvatar as UserAvatar, type UserAvatarProps, type UserContext, MemoizedUserFilter as UserFilter, UserMessage, type UserMessageActionsSlotProps, type UserMessageAttachmentsSlotProps, type UserMessageAvatarSlotProps, type UserMessageClassNames, type UserMessageContentSlotProps, type UserMessageProps, type UserMessageSlots, type UserTurn$1 as UserTurn, UserTurnView, type UserTurnViewProps, WelcomeContent, addCSRFHeader, backdropVariants, buttonVariants, convertToBase64, createDataUrl, createHeadersWithCSRF, createHttpDataSource, darkTheme, dropdownVariants, errorMessageVariants, fadeInUpVariants, fadeInVariants, floatingButtonVariants, formatFileSize, getCSRFToken, getFileVisual, getToolLabel, getValidChildren, groupSessionsByDate, groupSteps, hasPermission, isImageMimeType, isPermissionDeniedError, isTerminalEvent, lightTheme, listItemVariants, messageContainerVariants, messageVariants, parseBichatStream, parseBichatStreamEvents, parseSSEStream, readTextBlockOffsets, scaleFadeVariants, sessionItemVariants, splitIntoTextBlocks, staggerContainerVariants, toErrorDisplay, typingDotVariants, useActionButtonContext, useActiveRuns, useAttachments, useAutoScroll, useAvatarContext, useBichatRouter, useBubbleContext, useChatInput, useChatMessaging, useChatSession, useConfig, useDataTable, useFocusTrap, useHttpDataSourceConfigFromApplet, useImageGallery, useIotaContext, useKeyboardShortcuts, useLongPress, useMarkdownCopy, useMessageActions, useModalLock, useOptionalChatMessaging, useRequiredConfig, useScrollToBottom, useSidebarState, useStreaming, useTheme, useToast, useTranslation, useTurnContext, validateAttachmentFile, validateFileCount, validateImageFile, verbTransitionVariants };