@djangocfg/ui-tools 2.1.384 → 2.1.387

package/dist/index.d.ts

@@ -2249,815 +2249,813 @@ interface ChatRootProps {
 }
 declare function ChatRoot(props: ChatRootProps): react_jsx_runtime.JSX.Element;
 
-declare const LazyChat: react.ComponentType<ChatRootProps>;
-
-/**
- * Chat defaults and constants.
- */
-declare const STORAGE_KEYS: {
-    readonly mode: "djc-chat-mode";
-    readonly sidebarWidth: "djc-chat-sidebar-width";
-    readonly composerHistory: "djc-chat-composer-history";
-};
-declare const CSS_VARS: {
-    readonly reserve: "--djc-chat-reserve";
-};
-declare const DEFAULT_Z_INDEX = 9000;
-declare const LIMITS: {
-    /** Max characters per single message. */
-    readonly messageMaxLength: 8000;
-    /** Max attachments per message. */
-    readonly attachmentsMax: 10;
-    /** Composer history slots. */
-    readonly composerHistorySize: 50;
-    /** Coalesce stream tokens within this window before dispatching. */
-    readonly streamCoalesceMs: 16;
-    /** Default history page size. */
-    readonly pageSize: 50;
-    /** Virtualize list when >= this many messages (host-controlled threshold). */
-    readonly virtualizeThreshold: 50;
-    /** SSE idle timeout. */
-    readonly sseIdleMs: 45000;
-};
-declare const DEFAULT_SIDEBAR: {
-    readonly width: 420;
-    readonly min: 320;
-    readonly max: 720;
-};
-declare const HOTKEYS: {
-    readonly send: "mod+enter";
-    readonly cancel: "esc";
-    readonly newChat: "mod+shift+n";
-    readonly toggleOpen: "mod+/";
-    readonly focusComposer: "mod+l";
-};
-declare const CHAT_EVENT_NAME = "djc:chat:send";
-interface ChatEventDetail {
-    content: string;
-    sessionId?: string;
-    attachments?: unknown[];
-    metadata?: Record<string, unknown>;
+type ChatFABPosition = 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';
+type ChatFABVariant = 'simple' | 'animated' | 'glass';
+type ChatFABSize = 'sm' | 'md' | 'lg' | 'responsive';
+interface ChatFABProps {
+    /** Click handler — typically toggles a `ChatDock`. */
+    onClick: () => void;
+    /** Accessible label. */
+    ariaLabel?: string;
+    /** Icon inside the FAB. Defaults to a bot glyph. */
+    icon?: ReactNode;
+    /** Visual style. @default 'simple' */
+    variant?: ChatFABVariant;
+    /** Button size. @default 'md' */
+    size?: ChatFABSize;
+    /** Fixed-screen position. @default 'bottom-right' */
+    position?: ChatFABPosition;
+    /** Pixel offset from screen edges. @default 24 */
+    offset?: number;
+    /** z-index for the button. @default 9999 */
+    zIndex?: number;
+    /** Show a small attention dot (unread / new). */
+    pulse?: boolean;
+    /**
+     * Numeric badge — unread count. Numbers > 9 render as "9+".
+     * Overrides `pulse` when both set.
+     */
+    badge?: number;
+    /** Hover tooltip text. Shows next to the FAB on hover/focus. */
+    tooltip?: string;
+    /**
+     * Render in-place (no fixed positioning) so the FAB sits inline in the
+     * normal document flow. Useful for stories, screenshots, and previews
+     * inside a contained playground panel. @default false
+     */
+    inline?: boolean;
+    /** Override classes on the button itself. */
+    className?: string;
+    /** Extra style on the button (caller-controlled overrides). */
+    style?: CSSProperties;
 }
-
 /**
- * ID generation. Uses crypto.randomUUID when available with a fallback
- * for older environments (and SSR bundles that may not have crypto).
+ * Floating action button for opening a chat dock. Pure presentation — owns
+ * no state. Wire it to whatever toggles your dock open.
+ *
+ * For the common "FAB + dock + hotkey" composition, use `<ChatLauncher>` —
+ * this primitive is only useful when you need custom triggering.
  */
-declare function createId(prefix?: string): string;
+declare function ChatFAB({ onClick, ariaLabel, icon, variant, size, position, offset, zIndex, pulse, badge, tooltip, inline, className, style, }: ChatFABProps): react_jsx_runtime.JSX.Element;
 
-/**
- * Token coalescer. Buffers stream tokens within a small time window before
- * dispatching a single aggregated chunk. Prevents 60+ re-renders per second
- * on fast streams.
- */
-interface TokenBuffer {
-    /** Append a delta. Returns immediately. */
-    push(delta: string): void;
-    /** Force flush and resolve any pending timer. */
-    flush(): void;
-    /** Stop accepting tokens; flush whatever is buffered. */
-    close(): void;
+type ChatDockMode = 'popover' | 'side';
+type ChatDockSide = 'left' | 'right';
+interface ChatDockProps {
+    /** Controlled open state. */
+    open: boolean;
+    /** Called when the user clicks the close button. */
+    onClose: () => void;
+    /** Dock contents (typically a `<Chat>` component). */
+    children: ReactNode;
+    /**
+     * Visual mode.
+     * - `popover` (default): floating card anchored to a corner, fixed size, FAB-style.
+     * - `side`: docked panel pinned to the left/right edge, full viewport height.
+     */
+    mode?: ChatDockMode;
+    /** Side for `mode='side'`. @default 'right' */
+    side?: ChatDockSide;
+    /** Header title text. */
+    title?: ReactNode;
+    /** Header icon. Defaults to a bot glyph. */
+    icon?: ReactNode;
+    /**
+     * Header actions slot (right side, before the close button).
+     * Use `ChatHeaderActionButton` to keep visual consistency.
+     */
+    headerActions?: ReactNode;
+    /** Hide the header entirely (you render your own inside `children`). */
+    hideHeader?: boolean;
+    /** ARIA label for the close button. @default 'Close' */
+    closeLabel?: string;
+    /** Dock width in px. Clamped to viewport. @default 480 (popover) / 420 (side) */
+    width?: number;
+    /** Dock height in px. Only used in `popover` mode. @default 720 */
+    height?: number;
+    /** Which screen corner to dock to in `popover` mode. @default 'bottom-right' */
+    position?: ChatFABPosition;
+    /** Offset from screen edges in px (popover only). @default 24 / 96 */
+    offset?: {
+        horizontal?: number;
+        vertical?: number;
+    };
+    /** Transition duration in ms — should match CSS animation. @default 200 */
+    exitDurationMs?: number;
+    /** z-index. @default 10000 */
+    zIndex?: number;
+    /** Accessible dialog label. */
+    ariaLabel?: string;
+    /** Extra classes on the dock container. */
+    className?: string;
+    /**
+     * Take over the full viewport on mobile (< 768px). Applies to both modes.
+     * @default true
+     */
+    mobileFullscreen?: boolean;
+    /**
+     * Render in-place (not in `document.body` via a portal). Useful for stories,
+     * screenshots, or wrapping the dock inside a custom container. @default false
+     */
+    disablePortal?: boolean;
+    /**
+     * Drop fixed positioning entirely — the dock renders as a normal flow
+     * element sized by `width`/`height`. Combine with `disablePortal` for
+     * stories/previews where the dock should sit inside the panel instead
+     * of attaching to the viewport. @default false
+     */
+    inline?: boolean;
+    /**
+     * In `mode='side'`, reserve space on the document body so page content
+     * isn't covered by the dock. Sets `padding-{side}` on `<body>` while
+     * the dock is open and exposes the width via the `--chat-dock-reserve`
+     * CSS variable for custom layouts. @default true (when mode='side')
+     */
+    reserveBodySpace?: boolean;
 }
-declare function createTokenBuffer(onFlush: (delta: string) => void, windowMs?: 16): TokenBuffer;
-
-declare function resolvePersona(message: Pick<ChatMessage, 'role' | 'sender'>, user?: ChatUserContext, assistant?: ChatAssistantContext): ChatPersona;
-/** Compute initials for an avatar fallback. */
-declare function deriveInitials(persona: ChatPersona, role?: string): string;
-
 /**
- * HTTP + SSE transport. Default implementation for web hosts.
+ * Fixed-position chat surface. Two modes:
  *
- * Backend contract (see @dev/@refactoring7-chat/06-integration.md):
- *   POST   /sessions                     → SessionInfo (JSON)
- *   GET    /sessions/:id/history?cursor= → HistoryPage (JSON)
- *   POST   /sessions/:id/messages        → SSE stream of ChatStreamEvent
- *   POST   /sessions/:id/messages/buffered → ChatMessage (JSON, fallback)
- *   DELETE /sessions/:id                 → 204
+ * - `popover` — floating card anchored to a corner. Companion to `<ChatFAB>`.
+ * - `side` — full-height panel pinned to the left/right edge. App-shell style.
+ *
+ * Renders only when `open` is true (plus the leave-transition tail). Uses
+ * `useChatPresence` for the four-phase mount/animate/unmount cycle.
  */
+declare function ChatDock({ open, onClose, children, mode, side, title, icon, headerActions, hideHeader, closeLabel, width, height, position, offset, exitDurationMs, zIndex, ariaLabel, className, mobileFullscreen, disablePortal, inline, reserveBodySpace, }: ChatDockProps): react_jsx_runtime.JSX.Element;
 
-interface HttpTransportConfig {
-    /** Base URL without trailing slash, e.g. '/api/chat' or 'https://api.example.com/v1/chat'. */
-    baseUrl: string;
-    /** Optional slug appended/forwarded as project identifier. */
-    slug?: string;
-    /** Returns headers applied to every request — e.g. Authorization. */
-    getAuthHeader?: () => Record<string, string> | Promise<Record<string, string>>;
-    /** Default fetch timeout (per non-streaming request). */
-    timeoutMs?: number;
-    /** Override fetch implementation (useful for tests or custom retry layers). */
-    fetchImpl?: typeof fetch;
+interface ChatHeaderProps {
+    /** Window title text. */
+    title?: ReactNode;
+    /** Icon next to the title. Defaults to a bot glyph. */
+    icon?: ReactNode;
+    /**
+     * Action slot — appears to the right of the title, before the close button.
+     * Use for reset / settings / minimize / etc. Compose with `ChatHeaderActionButton`.
+     */
+    actions?: ReactNode;
+    /** Show the close (×) button. @default true */
+    showClose?: boolean;
+    /** Close click handler. */
+    onClose?: () => void;
+    /** ARIA label for the close button. @default 'Close' */
+    closeLabel?: string;
+    /** Replace the close button entirely (rare — most hosts want the default). */
+    closeSlot?: ReactNode;
+    /** Extra classes on the `<header>` element. */
+    className?: string;
 }
-declare function createHttpTransport(config: HttpTransportConfig): ChatTransport;
-
 /**
- * In-memory chat transport for stories and tests. Replays scripted replies.
+ * Standalone chat header — title + icon + action slot + close button.
+ *
+ * Used by `<ChatDock>` automatically, but can be rendered standalone when
+ * the host owns the chat container (e.g. embedded inline in a page).
  */
+declare function ChatHeader({ title, icon, actions, showClose, onClose, closeLabel, closeSlot, className, }: ChatHeaderProps): react_jsx_runtime.JSX.Element;
 
-interface MockTransportOptions {
-    /** Each entry is the assistant's reply for one user turn. Strings are split
-     *  into chunks; arrays are taken as the exact event sequence (after a
-     *  prepended `message_start` and before a synthetic `message_end`). */
-    replies?: Array<string | ChatStreamEvent[]>;
-    latencyMs?: number;
-    /** Initial history returned by `createSession`. */
-    initialMessages?: ChatMessage[];
-    shouldFail?: (attempt: number) => boolean;
+interface ChatHeaderActionButtonProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'children'> {
+    /** Icon (required). */
+    icon: ReactNode;
+    /** Accessible label + native tooltip. */
+    ariaLabel: string;
+    /** Optional unread / status badge — small number on top-right. */
+    badge?: number;
+    /** Mark as destructive — uses destructive hover tokens. */
+    destructive?: boolean;
+    /** Optional visual loading state (e.g. while reset is in flight). */
+    loading?: boolean;
 }
-declare function createMockTransport(opts?: MockTransportOptions): ChatTransport;
-
 /**
- * Server-Sent Events parser as an AsyncGenerator.
+ * Compact icon button for the chat header actions slot.
  *
- * Yields parsed events from a `Response` body. Handles the split-read case
- * where `event:` and `data:` arrive in separate TCP packets. Skips malformed
- * JSON gracefully. Honors AbortSignal (caller passes one to fetch).
+ * Standard chrome: 28×28 ghost button, hover bg-accent, focus ring, optional
+ * destructive variant, optional numeric badge for unread / pending.
+ *
+ * @example
+ * ```tsx
+ * <ChatHeader
+ *   title="Assistant"
+ *   onClose={close}
+ *   actions={
+ *     <>
+ *       <ChatHeaderActionButton
+ *         icon={<RotateCcw className="h-3.5 w-3.5" />}
+ *         ariaLabel="Clear context"
+ *         onClick={handleReset}
+ *         loading={isResetting}
+ *       />
+ *       <ChatHeaderActionButton
+ *         icon={<Settings className="h-3.5 w-3.5" />}
+ *         ariaLabel="Settings"
+ *         onClick={openSettings}
+ *       />
+ *     </>
+ *   }
+ * />
+ * ```
  */
+declare const ChatHeaderActionButton: react.ForwardRefExoticComponent<ChatHeaderActionButtonProps & react.RefAttributes<HTMLButtonElement>>;
 
-interface RawEvent {
-    event?: string;
-    data?: string;
-}
-interface ParseSSEOptions {
-    signal?: AbortSignal;
-    /** Map a raw SSE event to zero, one, or many `ChatStreamEvent`s.
-     *  Default: parse `data` as JSON and assume the JSON shape already
-     *  matches `ChatStreamEvent`. */
-    map?: (raw: RawEvent) => ChatStreamEvent | ChatStreamEvent[] | null;
-    idleTimeoutMs?: number;
+interface ChatHeaderModeToggleProps {
+    /** Current dock mode. */
+    mode: ChatDockMode;
+    /** Toggle handler. Wire to `useChatDockPrefs().toggleMode`. */
+    onToggle: () => void;
+    /** Override aria/tooltip label for popover→side. */
+    expandLabel?: string;
+    /** Override aria/tooltip label for side→popover. */
+    collapseLabel?: string;
+    /**
+     * Always render — useful for stories. By default the toggle hides itself on
+     * viewports below `lg` (1024px) since side mode falls back to popover there.
+     */
+    forceVisible?: boolean;
 }
-declare function parseSSE(response: Response, options?: ParseSSEOptions): AsyncGenerator<ChatStreamEvent, void, void>;
-
 /**
- * Transport surface re-export. Lives in core so transport implementations
- * never need to reach into the public types module.
+ * "Dock to side" / "back to popover" toggle.
+ *
+ * Side mode is desktop-only — on viewports below `lg` (1024px) `<ChatDock>`
+ * silently falls back to popover anyway, so the toggle has nothing to do
+ * and auto-hides. Pass `forceVisible` to override (e.g. in stories).
  */
+declare function ChatHeaderModeToggle({ mode, onToggle, expandLabel, collapseLabel, forceVisible, }: ChatHeaderModeToggleProps): react_jsx_runtime.JSX.Element;
 
-declare class TransportError extends Error {
-    code: string;
-    constructor(message: string, code?: string);
+interface ChatHeaderAudioToggleProps {
+    /** Current muted state. */
+    muted: boolean;
+    /** Toggle handler. Wire to `useChatAudio().setMuted` or `toggleMute`. */
+    onToggle: () => void;
+    /** Override tooltip label for muted → unmuted. */
+    unmuteLabel?: string;
+    /** Override tooltip label for unmuted → muted. */
+    muteLabel?: string;
 }
-
 /**
- * Pydantic-AI SSE event mapper.
- *
- * Translates the event shape emitted by pydantic-AI–style Django backends
- * (text_delta / tool_call / tool_result / done / error / approval_required)
- * into the canonical `ChatStreamEvent` stream consumed by the Chat reducer.
+ * Mute / unmute notification sounds. Drop into a `<ChatHeader>` actions
+ * slot or into `<ChatDock headerActions>`.
  *
- * Backends that don't expose a stable `tool_call_id` are supported via a
- * per-stream FIFO queue keyed by tool name. The earlier "Map<name, toolId>"
- * approach lost the first toolId when a tool was invoked twice in one turn
- * (e.g. `list_tasks` for search and again for confirmation) — using a queue
- * keeps each call/result pair correctly matched.
+ * @example
+ * ```tsx
+ * const audio = useChatAudio({ sounds: {...} });
+ * <ChatHeaderAudioToggle muted={audio.muted} onToggle={() => audio.setMuted(!audio.muted)} />
+ * ```
  */
+declare function ChatHeaderAudioToggle({ muted, onToggle, unmuteLabel, muteLabel, }: ChatHeaderAudioToggleProps): react_jsx_runtime.JSX.Element;
 
-interface PydanticAIEvent {
-    type: 'text_delta' | 'tool_call' | 'tool_result' | 'done' | 'error' | 'approval_required';
-    delta?: string;
-    tool?: string;
-    args?: unknown;
-    result?: unknown;
+interface ChatHeaderResetButtonProps {
     /**
-     * Structured frontend payload — present on `tool_result` when the tool has
-     * a `result_schema`. The LLM sees only `result` (compact text); the
-     * frontend uses `data` to render rich UI (e.g. vehicle cards).
+     * Backend reset call. Should resolve to `true` on success.
+     * Plugged into `useChatReset` for in-flight state.
      */
-    data?: unknown;
-    total_tokens?: number;
-    error?: string;
-    tool_call_id?: string;
-    session_id?: string;
-}
-/** Per-stream FIFO queue keyed by tool name. Created via `createToolIdQueue`. */
-interface ToolIdQueue {
-    /** Allocate a new toolId for a `tool_call` event and enqueue it under `name`. */
-    push(name: string): string;
-    /** Pop the oldest toolId for `name` (or return an orphan marker if none). */
-    shift(name: string): string;
-    /** Reset all queues (e.g. on stream close). */
-    clear(): void;
+    onReset: () => Promise<boolean>;
+    /** Called after a successful reset (e.g. clear local messages, refetch). */
+    onSuccess?: () => void;
+    /** Called when reset fails (returned `false` or threw). */
+    onError?: (error?: unknown) => void;
+    /**
+     * Show a `window.dialog.confirm` before calling `onReset`. @default true
+     *
+     * Requires the host to mount `<DialogProvider>` from `@djangocfg/ui-core`
+     * — it installs the `window.dialog` API used here.
+     */
+    confirm?: boolean;
+    /** Confirm dialog title. */
+    confirmTitle?: string;
+    /** Confirm dialog message. */
+    confirmMessage?: string;
+    /** Override tooltip / aria label. */
+    ariaLabel?: string;
 }
-declare function createToolIdQueue(): ToolIdQueue;
-/**
- * Translate a single pydantic-AI event into zero or more `ChatStreamEvent`s.
- * Pass a `ToolIdQueue` shared across the lifetime of one stream so that
- * `tool_call` / `tool_result` pairs match correctly.
- */
-declare function mapPydanticAIEvent(ev: PydanticAIEvent, toolIds: ToolIdQueue): Generator<ChatStreamEvent>;
 /**
- * Convenience factory: returns a `ParseSSEOptions['map']` callback that
- * decodes raw SSE frames as `PydanticAIEvent` JSON and yields zero or
- * more `ChatStreamEvent`s through `mapPydanticAIEvent`.
+ * Standard chat-reset action: prompts the user via `window.dialog.confirm`,
+ * then runs the backend reset call through `useChatReset` so the button
+ * spins while it's in flight.
  *
- * Allocates an internal `ToolIdQueue` — call this once per stream.
+ * @example
+ * ```tsx
+ * <ChatHeaderResetButton
+ *   onReset={api.clearChat}
+ *   onSuccess={() => chat.clearMessages()}
+ * />
+ * ```
  */
-declare function createPydanticAISSEMap(): NonNullable<ParseSSEOptions['map']>;
+declare function ChatHeaderResetButton({ onReset, onSuccess, onError, confirm, confirmTitle, confirmMessage, ariaLabel, }: ChatHeaderResetButtonProps): react_jsx_runtime.JSX.Element;
 
+interface ChatHeaderLanguageButtonProps {
+    /** Override aria-label. Default "Speech language". */
+    ariaLabel?: string;
+    /**
+     * Subset of BCP-47 tags to offer. Default: every entry from the
+     * Web Speech catalogue (~66 tags incl. regional variants). Pass a
+     * tighter list when your backend STT only supports a subset.
+     */
+    allowedTags?: string[];
+    /** Hide the globe-fallback icon when no flag resolves. */
+    hideFallbackIcon?: boolean;
+    className?: string;
+}
 /**
- * High-level transport factory for pydantic-AI–style backends.
- *
- * Composes:
- *   - `parseSSE` for spec-compliant SSE framing (multi-line `data:`, comments, idle timeout).
- *   - `createPydanticAISSEMap` for normalizing pydantic-AI events into `ChatStreamEvent`.
+ * Compact flag-button language picker for the chat header. Built on
+ * top of the ui-core `<Combobox>` — searchable autocomplete with
+ * flags, ~66 BCP-47 tags from the official Chrome Web Speech demo, and
+ * a custom 28×28 trigger via `renderTrigger`.
  *
- * Use when your backend speaks the canonical pydantic-AI stream shape
- * (`text_delta` / `tool_call` / `tool_result` / `done` / `error`).
- * URL building, auth headers, history loading, and optional session
- * bootstrapping are caller responsibilities — pass them in.
+ * The selection persists into `useSpeechPrefs` (zustand+localStorage)
+ * so `useSpeechRecognition` picks it up as the second-priority resolver
+ * value (above i18n locale, below an explicit `language` prop).
  */
+declare function ChatHeaderLanguageButton({ ariaLabel, allowedTags, hideFallbackIcon, className, }: ChatHeaderLanguageButtonProps): react.ReactElement;
 
-interface PydanticAIChatTransportOpts {
-    /**
-     * Build the SSE stream URL for a user message turn.
-     * @example (sessionId, message) => `${base}/stream?session_id=${sessionId}&message=${encodeURIComponent(message)}`
-     */
-    buildStreamUrl: (sessionId: string, message: string) => string | URL;
-    /** Optional history loader. If omitted, `loadHistory` returns an empty page. */
-    loadHistory?: (sessionId: string, cursor?: string | null) => Promise<HistoryPage>;
-    /**
-     * Optional session bootstrap. Called from `createSession`. Useful for
-     * backends that need a `POST /sessions` round-trip or want to pre-seed
-     * history.
-     */
-    bootstrapSession?: (opts?: CreateSessionOptions) => Promise<SessionInfo>;
-    /** Optional session teardown. */
-    closeSession?: (sessionId: string) => Promise<void>;
+interface ChatGreetingProps {
+    /** Controlled visibility — usually `!chatOpen && !userDismissed`. */
+    open: boolean;
+    /** Greeting text. Pass a string for the default bubble, or any ReactNode. */
+    children: ReactNode;
+    /** Click handler — typically opens the chat. Bubble is clickable when set. */
+    onClick?: () => void;
+    /** Close (×) button handler — typically marks the greeting as dismissed. */
+    onDismiss?: () => void;
+    /** Anchor relative to a FAB on the same side. @default 'bottom-right' */
+    position?: ChatFABPosition;
     /**
-     * Optional non-streaming send (for hosts that need a buffered fallback,
-     * e.g. when the user disables streaming). Defaults to throwing — most
-     * hosts only use streaming.
+     * Horizontal pixel offset matching the FAB's `offset` prop, so the greeting
+     * lines up under the FAB. @default 24
      */
-    send?: (sessionId: string, content: string, options?: SendOptions) => Promise<ChatMessage>;
-    /** Request headers (Authorization, content-type, etc.). */
-    buildHeaders?: () => HeadersInit | Promise<HeadersInit>;
-    /** Override fetch (tests, retry layers). */
-    fetchImpl?: typeof fetch;
+    fabOffset?: number;
     /**
-     * HTTP method for the stream request. Defaults to `'POST'` with
-     * `{ content, attachments, metadata }` JSON body. Set to `'GET'` if
-     * your backend embeds the message in the URL via `buildStreamUrl`.
+     * Vertical pixel offset above/below the FAB centerline. @default 96
+     * (room for an `md` FAB plus a small gap).
      */
-    streamMethod?: 'GET' | 'POST';
-    /** Idle timeout for the SSE connection, in ms. Forwarded to `parseSSE`. */
-    idleTimeoutMs?: number;
+    fabClearance?: number;
+    /** Delay before the greeting appears, in ms. @default 1500 */
+    delayMs?: number;
+    /** z-index. @default 9998 (just below the default FAB at 9999). */
+    zIndex?: number;
+    /** Override classes on the bubble. */
+    className?: string;
+    /** Override styles on the bubble. */
+    style?: CSSProperties;
+    /** Optional sender avatar / icon shown on the left. */
+    avatar?: ReactNode;
+    /** Optional sender label rendered above the text. */
+    senderName?: string;
+    /** ARIA label for the dismiss button. @default 'Dismiss' */
+    dismissLabel?: string;
     /**
-     * Side-channel for events that don't translate to `ChatStreamEvent`
-     * (e.g. `approval_required` — surfaces interactive prompts outside the
-     * normal message stream). Called synchronously while parsing the SSE
-     * frame; mutate caller-owned state, don't `await` long work here.
+     * Render in-place (no fixed positioning). Useful for stories and inline previews.
+     * @default false
      */
-    onPydanticEvent?: (event: PydanticAIEvent) => void;
+    inline?: boolean;
 }
-declare function createPydanticAIChatTransport(opts: PydanticAIChatTransportOpts): ChatTransport;
+/**
+ * Greeting bubble shown next to a `ChatFAB` to invite the user to start a
+ * conversation (LiveChat / Intercom-style proactive prompt).
+ *
+ * Renders fixed-position, anchored to the same corner as the FAB. Owns its
+ * own delayed-mount + presence animation. Hide on chat open and/or after
+ * user dismissal.
+ *
+ * @example
+ * ```tsx
+ * const [open, setOpen] = useState(false);
+ * const [dismissed, setDismissed] = useState(false);
+ *
+ * <ChatLauncher
+ *   open={open}
+ *   onOpenChange={setOpen}
+ *   fab={{ variant: 'animated' }}
+ *   dock={{ title: 'Support' }}
+ * >
+ *   <SupportChat />
+ * </ChatLauncher>
+ *
+ * <ChatGreeting
+ *   open={!open && !dismissed}
+ *   onClick={() => setOpen(true)}
+ *   onDismiss={() => setDismissed(true)}
+ *   senderName="Anna from Support"
+ *   delayMs={2000}
+ * >
+ *   Hi! 👋 Got a question? I'm here to help.
+ * </ChatGreeting>
+ * ```
+ */
+declare function ChatGreeting({ open, children, onClick, onDismiss, position, fabOffset, fabClearance, delayMs, zIndex, className, style, avatar, senderName, dismissLabel, inline, }: ChatGreetingProps): react_jsx_runtime.JSX.Element;
 
-type ChatFABPosition = 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';
-type ChatFABVariant = 'simple' | 'animated' | 'glass';
-type ChatFABSize = 'sm' | 'md' | 'lg' | 'responsive';
-interface ChatFABProps {
-    /** Click handler — typically toggles a `ChatDock`. */
-    onClick: () => void;
-    /** Accessible label. */
-    ariaLabel?: string;
-    /** Icon inside the FAB. Defaults to a bot glyph. */
-    icon?: ReactNode;
-    /** Visual style. @default 'simple' */
-    variant?: ChatFABVariant;
-    /** Button size. @default 'md' */
-    size?: ChatFABSize;
-    /** Fixed-screen position. @default 'bottom-right' */
+interface ChatUnreadPreviewProps {
+    /** Controlled — usually `!dockOpen && !!message`. */
+    open: boolean;
+    /** Inbound message to preview. `null` hides the bubble. */
+    message: ChatMessage | null;
+    /** Tap → open chat + mark read. */
+    onClick?: () => void;
+    /** × → mark read without opening. */
+    onDismiss?: () => void;
+    /** Anchor corner — match the FAB so the bubble sits above it. @default 'bottom-right' */
     position?: ChatFABPosition;
-    /** Pixel offset from screen edges. @default 24 */
-    offset?: number;
-    /** z-index for the button. @default 9999 */
+    /** Horizontal offset from screen edge, matches the FAB. @default 24 */
+    fabOffset?: number;
+    /** Vertical clearance above/below the FAB. @default 96 */
+    fabClearance?: number;
+    /** Lines of body text before ellipsis. @default 2 */
+    truncate?: number;
+    /** z-index. @default 9998 */
     zIndex?: number;
-    /** Show a small attention dot (unread / new). */
-    pulse?: boolean;
-    /**
-     * Numeric badge — unread count. Numbers > 9 render as "9+".
-     * Overrides `pulse` when both set.
-     */
-    badge?: number;
-    /** Hover tooltip text. Shows next to the FAB on hover/focus. */
-    tooltip?: string;
-    /**
-     * Render in-place (no fixed positioning) so the FAB sits inline in the
-     * normal document flow. Useful for stories, screenshots, and previews
-     * inside a contained playground panel. @default false
-     */
+    /** Render in-place (stories / previews). @default false */
     inline?: boolean;
-    /** Override classes on the button itself. */
+    /** Override classes on the bubble. */
     className?: string;
-    /** Extra style on the button (caller-controlled overrides). */
+    /** Override styles on the bubble. */
     style?: CSSProperties;
+    /** ARIA label for the dismiss button. @default 'Mark as read' */
+    dismissLabel?: string;
+    /** Override the avatar — defaults to derived from `message.sender`. */
+    avatar?: ReactNode;
+    /** Override the sender label — defaults to `message.sender?.name`. */
+    senderName?: string;
 }
 /**
- * Floating action button for opening a chat dock. Pure presentation — owns
- * no state. Wire it to whatever toggles your dock open.
+ * Push-notification bubble next to the chat FAB.
  *
- * For the common "FAB + dock + hotkey" composition, use `<ChatLauncher>` —
- * this primitive is only useful when you need custom triggering.
+ * Shows the last inbound message while the chat is closed —
+ * Intercom / LiveChat-style. Tap → open chat (host wires `onClick`).
+ * Dismiss × → keep chat closed but stop nagging.
+ *
+ * Pair with `useChatUnread()` (inside `<ChatProvider>`) for state.
  */
-declare function ChatFAB({ onClick, ariaLabel, icon, variant, size, position, offset, zIndex, pulse, badge, tooltip, inline, className, style, }: ChatFABProps): react_jsx_runtime.JSX.Element;
+declare function ChatUnreadPreview({ open, message, onClick, onDismiss, position, fabOffset, fabClearance, truncate, zIndex, inline, className, style, dismissLabel, avatar, senderName, }: ChatUnreadPreviewProps): react_jsx_runtime.JSX.Element;
 
-type ChatDockMode = 'popover' | 'side';
-type ChatDockSide = 'left' | 'right';
-interface ChatDockProps {
-    /** Controlled open state. */
-    open: boolean;
-    /** Called when the user clicks the close button. */
-    onClose: () => void;
-    /** Dock contents (typically a `<Chat>` component). */
+interface ChatLauncherHotkey {
+    /** Key (case-sensitive single char or named like 'Escape'). */
+    key: string;
+    /** Require Cmd (mac) or Ctrl (other). */
+    meta?: boolean;
+    /** Require Shift. */
+    shift?: boolean;
+    /** Require Alt. */
+    alt?: boolean;
+}
+interface ChatLauncherGreeting extends Omit<ChatGreetingProps, 'open' | 'onClick' | 'onDismiss' | 'position' | 'fabOffset' | 'children'> {
+    /** Greeting body — string for the default style, or any ReactNode. */
+    content: ReactNode;
+    /** Persistence key for "user dismissed this greeting" in `localStorage`. Pass `null` to disable persistence. @default null */
+    dismissStorageKey?: string | null;
+    /** Hide the greeting once the user opens the chat. @default true */
+    hideOnOpen?: boolean;
+}
+interface ChatLauncherProps {
+    /** Dock contents — typically a `<Chat>` instance. */
     children: ReactNode;
+    /** FAB customization (icon, position, label, pulse, badge, tooltip, variant, size). */
+    fab?: Omit<ChatFABProps, 'onClick'>;
+    /** Dock customization (size, title, position, transition, mobileFullscreen). */
+    dock?: Omit<ChatDockProps, 'open' | 'onClose' | 'children'>;
     /**
-     * Visual mode.
-     * - `popover` (default): floating card anchored to a corner, fixed size, FAB-style.
-     * - `side`: docked panel pinned to the left/right edge, full viewport height.
+     * Proactive greeting bubble shown next to the FAB before the user opens the chat.
+     * Set to a string or full config object. Omit to disable.
      */
-    mode?: ChatDockMode;
-    /** Side for `mode='side'`. @default 'right' */
-    side?: ChatDockSide;
-    /** Header title text. */
-    title?: ReactNode;
-    /** Header icon. Defaults to a bot glyph. */
-    icon?: ReactNode;
+    greeting?: string | ChatLauncherGreeting;
+    /** Open/close via a keyboard shortcut. */
+    hotkey?: ChatLauncherHotkey;
+    /** Initial open state for uncontrolled mode. @default false */
+    defaultOpen?: boolean;
+    /** Controlled open state (pair with `onOpenChange`). */
+    open?: boolean;
+    /** Controlled open state setter. */
+    onOpenChange?: (open: boolean) => void;
     /**
-     * Header actions slot (right side, before the close button).
-     * Use `ChatHeaderActionButton` to keep visual consistency.
+     * Focus the composer textarea when the dock opens. Saves a click for
+     * every "FAB → start typing" interaction. @default true
      */
-    headerActions?: ReactNode;
-    /** Hide the header entirely (you render your own inside `children`). */
-    hideHeader?: boolean;
-    /** ARIA label for the close button. @default 'Close' */
-    closeLabel?: string;
-    /** Dock width in px. Clamped to viewport. @default 480 (popover) / 420 (side) */
-    width?: number;
-    /** Dock height in px. Only used in `popover` mode. @default 720 */
-    height?: number;
-    /** Which screen corner to dock to in `popover` mode. @default 'bottom-right' */
-    position?: ChatFABPosition;
-    /** Offset from screen edges in px (popover only). @default 24 / 96 */
-    offset?: {
-        horizontal?: number;
-        vertical?: number;
-    };
-    /** Transition duration in ms — should match CSS animation. @default 200 */
-    exitDurationMs?: number;
-    /** z-index. @default 10000 */
-    zIndex?: number;
-    /** Accessible dialog label. */
-    ariaLabel?: string;
-    /** Extra classes on the dock container. */
-    className?: string;
+    autoFocusComposerOnOpen?: boolean;
     /**
-     * Take over the full viewport on mobile (< 768px). Applies to both modes.
-     * @default true
+     * Close the dock on `Escape`. Mirrors standard popover / drawer UX.
+     * Set to `false` to disable (e.g. if you want Escape to do something
+     * else inside the chat). @default true
      */
-    mobileFullscreen?: boolean;
+    closeOnEscape?: boolean;
     /**
-     * Render in-place (not in `document.body` via a portal). Useful for stories,
-     * screenshots, or wrapping the dock inside a custom container. @default false
+     * Last inbound message (admin reply / system notice / agent push) the
+     * user hasn't seen yet. Drives the `<ChatUnreadPreview>` bubble next
+     * to the FAB and (by default) the FAB badge.
+     *
+     * Source it from `useChatUnread()` inside your `<ChatProvider>`.
      */
-    disablePortal?: boolean;
+    unreadMessage?: ChatMessage | null;
     /**
-     * Drop fixed positioning entirely — the dock renders as a normal flow
-     * element sized by `width`/`height`. Combine with `disablePortal` for
-     * stories/previews where the dock should sit inside the panel instead
-     * of attaching to the viewport. @default false
+     * Called when the user opens the chat via FAB/preview/hotkey or
+     * dismisses the preview with ×. Wire to `useChatUnread().markRead`.
      */
-    inline?: boolean;
+    onMarkRead?: () => void;
     /**
-     * In `mode='side'`, reserve space on the document body so page content
-     * isn't covered by the dock. Sets `padding-{side}` on `<body>` while
-     * the dock is open and exposes the width via the `--chat-dock-reserve`
-     * CSS variable for custom layouts. @default true (when mode='side')
+     * Customize the unread bubble (`truncate`, `dismissLabel`, …).
+     * `open`/`message`/`onClick`/`onDismiss`/`position`/`fabOffset` are
+     * wired automatically.
      */
-    reserveBodySpace?: boolean;
-}
-/**
- * Fixed-position chat surface. Two modes:
- *
- * - `popover` — floating card anchored to a corner. Companion to `<ChatFAB>`.
- * - `side` — full-height panel pinned to the left/right edge. App-shell style.
- *
- * Renders only when `open` is true (plus the leave-transition tail). Uses
- * `useChatPresence` for the four-phase mount/animate/unmount cycle.
- */
-declare function ChatDock({ open, onClose, children, mode, side, title, icon, headerActions, hideHeader, closeLabel, width, height, position, offset, exitDurationMs, zIndex, ariaLabel, className, mobileFullscreen, disablePortal, inline, reserveBodySpace, }: ChatDockProps): react_jsx_runtime.JSX.Element;
-
-interface ChatHeaderProps {
-    /** Window title text. */
-    title?: ReactNode;
-    /** Icon next to the title. Defaults to a bot glyph. */
-    icon?: ReactNode;
+    unreadPreview?: Omit<ChatUnreadPreviewProps, 'open' | 'message' | 'onClick' | 'onDismiss' | 'position' | 'fabOffset'>;
     /**
-     * Action slot — appears to the right of the title, before the close button.
-     * Use for reset / settings / minimize / etc. Compose with `ChatHeaderActionButton`.
+     * Auto-inject a mute / unmute button into the header. Pass the
+     * `useChatAudio()` (or any compatible `{ muted, toggleMute }`)
+     * instance — the launcher renders `<ChatHeaderAudioToggle>` in the
+     * header's actions slot when audio is actually configured (not silent).
+     *
+     * Hosts that manage their own header can ignore this prop and render
+     * `<ChatHeaderAudioToggle>` directly.
      */
-    actions?: ReactNode;
-    /** Show the close (×) button. @default true */
-    showClose?: boolean;
-    /** Close click handler. */
-    onClose?: () => void;
-    /** ARIA label for the close button. @default 'Close' */
-    closeLabel?: string;
-    /** Replace the close button entirely (rare — most hosts want the default). */
-    closeSlot?: ReactNode;
-    /** Extra classes on the `<header>` element. */
-    className?: string;
+    audio?: {
+        muted: boolean;
+        toggleMute: () => void;
+        isSilent?: boolean;
+    } | null;
+    /**
+     * Suppress the auto-injected audio toggle even when `audio` is passed.
+     * @default false
+     */
+    hideAudioToggle?: boolean;
 }
 /**
- * Standalone chat header — title + icon + action slot + close button.
+ * Floating chat launcher = FAB + Dock + presence + optional greeting + hotkey.
  *
- * Used by `<ChatDock>` automatically, but can be rendered standalone when
- * the host owns the chat container (e.g. embedded inline in a page).
+ * 99% of hosts use this directly. For non-FAB triggers (e.g. an inline
+ * link in the page) compose `<ChatDock>` with your own button.
  */
-declare function ChatHeader({ title, icon, actions, showClose, onClose, closeLabel, closeSlot, className, }: ChatHeaderProps): react_jsx_runtime.JSX.Element;
+declare function ChatLauncher({ children, fab, dock, greeting, hotkey, defaultOpen, open: controlledOpen, onOpenChange, autoFocusComposerOnOpen, closeOnEscape, unreadMessage, onMarkRead, unreadPreview, audio, hideAudioToggle, }: ChatLauncherProps): react_jsx_runtime.JSX.Element;
 
-interface ChatHeaderActionButtonProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'children'> {
-    /** Icon (required). */
-    icon: ReactNode;
-    /** Accessible label + native tooltip. */
-    ariaLabel: string;
-    /** Optional unread / status badge — small number on top-right. */
-    badge?: number;
-    /** Mark as destructive — uses destructive hover tokens. */
-    destructive?: boolean;
-    /** Optional visual loading state (e.g. while reset is in flight). */
-    loading?: boolean;
-}
+type ChatPresencePhase = 'hidden' | 'entering' | 'visible' | 'leaving';
 /**
- * Compact icon button for the chat header actions slot.
+ * Presence state machine for floating popovers.
  *
- * Standard chrome: 28×28 ghost button, hover bg-accent, focus ring, optional
- * destructive variant, optional numeric badge for unread / pending.
+ * Drives a four-phase lifecycle so enter/leave CSS transitions actually fire:
  *
- * @example
- * ```tsx
- * <ChatHeader
- *   title="Assistant"
- *   onClose={close}
- *   actions={
- *     <>
- *       <ChatHeaderActionButton
- *         icon={<RotateCcw className="h-3.5 w-3.5" />}
- *         ariaLabel="Clear context"
- *         onClick={handleReset}
- *         loading={isResetting}
- *       />
- *       <ChatHeaderActionButton
- *         icon={<Settings className="h-3.5 w-3.5" />}
- *         ariaLabel="Settings"
- *         onClick={openSettings}
- *       />
- *     </>
- *   }
- * />
- * ```
+ *   hidden → entering (mount, transition class starts) → visible
+ *   visible → leaving (transition runs) → hidden (unmount)
+ *
+ * Mounting in `entering` and ticking to `visible` on the next paint is what
+ * lets transition classes animate. Without it the element appears already
+ * at its final state and CSS transitions never observe a change.
+ *
+ * @param open - controlled open state
+ * @param exitDurationMs - how long the leave transition runs; should match CSS
  */
-declare const ChatHeaderActionButton: react.ForwardRefExoticComponent<ChatHeaderActionButtonProps & react.RefAttributes<HTMLButtonElement>>;
+declare function useChatPresence(open: boolean, exitDurationMs?: number): ChatPresencePhase;
 
-interface ChatHeaderModeToggleProps {
-    /** Current dock mode. */
-    mode: ChatDockMode;
-    /** Toggle handler. Wire to `useChatDockPrefs().toggleMode`. */
-    onToggle: () => void;
-    /** Override aria/tooltip label for popover→side. */
-    expandLabel?: string;
-    /** Override aria/tooltip label for side→popover. */
-    collapseLabel?: string;
-    /**
-     * Always render — useful for stories. By default the toggle hides itself on
-     * viewports below `lg` (1024px) since side mode falls back to popover there.
-     */
-    forceVisible?: boolean;
+/**
+ * Chat defaults and constants.
+ */
+declare const STORAGE_KEYS: {
+    readonly mode: "djc-chat-mode";
+    readonly sidebarWidth: "djc-chat-sidebar-width";
+    readonly composerHistory: "djc-chat-composer-history";
+};
+declare const CSS_VARS: {
+    readonly reserve: "--djc-chat-reserve";
+};
+declare const DEFAULT_Z_INDEX = 9000;
+declare const LIMITS: {
+    /** Max characters per single message. */
+    readonly messageMaxLength: 8000;
+    /** Max attachments per message. */
+    readonly attachmentsMax: 10;
+    /** Composer history slots. */
+    readonly composerHistorySize: 50;
+    /** Coalesce stream tokens within this window before dispatching. */
+    readonly streamCoalesceMs: 16;
+    /** Default history page size. */
+    readonly pageSize: 50;
+    /** Virtualize list when >= this many messages (host-controlled threshold). */
+    readonly virtualizeThreshold: 50;
+    /** SSE idle timeout. */
+    readonly sseIdleMs: 45000;
+};
+declare const DEFAULT_SIDEBAR: {
+    readonly width: 420;
+    readonly min: 320;
+    readonly max: 720;
+};
+declare const HOTKEYS: {
+    readonly send: "mod+enter";
+    readonly cancel: "esc";
+    readonly newChat: "mod+shift+n";
+    readonly toggleOpen: "mod+/";
+    readonly focusComposer: "mod+l";
+};
+declare const CHAT_EVENT_NAME = "djc:chat:send";
+interface ChatEventDetail {
+    content: string;
+    sessionId?: string;
+    attachments?: unknown[];
+    metadata?: Record<string, unknown>;
 }
+
 /**
- * "Dock to side" / "back to popover" toggle.
- *
- * Side mode is desktop-only — on viewports below `lg` (1024px) `<ChatDock>`
- * silently falls back to popover anyway, so the toggle has nothing to do
- * and auto-hides. Pass `forceVisible` to override (e.g. in stories).
+ * ID generation. Uses crypto.randomUUID when available with a fallback
+ * for older environments (and SSR bundles that may not have crypto).
  */
-declare function ChatHeaderModeToggle({ mode, onToggle, expandLabel, collapseLabel, forceVisible, }: ChatHeaderModeToggleProps): react_jsx_runtime.JSX.Element;
+declare function createId(prefix?: string): string;
 
-interface ChatHeaderAudioToggleProps {
-    /** Current muted state. */
-    muted: boolean;
-    /** Toggle handler. Wire to `useChatAudio().setMuted` or `toggleMute`. */
-    onToggle: () => void;
-    /** Override tooltip label for muted → unmuted. */
-    unmuteLabel?: string;
-    /** Override tooltip label for unmuted → muted. */
-    muteLabel?: string;
+/**
+ * Token coalescer. Buffers stream tokens within a small time window before
+ * dispatching a single aggregated chunk. Prevents 60+ re-renders per second
+ * on fast streams.
+ */
+interface TokenBuffer {
+    /** Append a delta. Returns immediately. */
+    push(delta: string): void;
+    /** Force flush and resolve any pending timer. */
+    flush(): void;
+    /** Stop accepting tokens; flush whatever is buffered. */
+    close(): void;
 }
+declare function createTokenBuffer(onFlush: (delta: string) => void, windowMs?: 16): TokenBuffer;
+
+declare function resolvePersona(message: Pick<ChatMessage, 'role' | 'sender'>, user?: ChatUserContext, assistant?: ChatAssistantContext): ChatPersona;
+/** Compute initials for an avatar fallback. */
+declare function deriveInitials(persona: ChatPersona, role?: string): string;
+
 /**
- * Mute / unmute notification sounds. Drop into a `<ChatHeader>` actions
- * slot or into `<ChatDock headerActions>`.
+ * HTTP + SSE transport. Default implementation for web hosts.
  *
- * @example
- * ```tsx
- * const audio = useChatAudio({ sounds: {...} });
- * <ChatHeaderAudioToggle muted={audio.muted} onToggle={() => audio.setMuted(!audio.muted)} />
- * ```
+ * Backend contract (see @dev/@refactoring7-chat/06-integration.md):
+ *   POST   /sessions                     → SessionInfo (JSON)
+ *   GET    /sessions/:id/history?cursor= → HistoryPage (JSON)
+ *   POST   /sessions/:id/messages        → SSE stream of ChatStreamEvent
+ *   POST   /sessions/:id/messages/buffered → ChatMessage (JSON, fallback)
+ *   DELETE /sessions/:id                 → 204
  */
-declare function ChatHeaderAudioToggle({ muted, onToggle, unmuteLabel, muteLabel, }: ChatHeaderAudioToggleProps): react_jsx_runtime.JSX.Element;
 
-interface ChatHeaderResetButtonProps {
-    /**
-     * Backend reset call. Should resolve to `true` on success.
-     * Plugged into `useChatReset` for in-flight state.
-     */
-    onReset: () => Promise<boolean>;
-    /** Called after a successful reset (e.g. clear local messages, refetch). */
-    onSuccess?: () => void;
-    /** Called when reset fails (returned `false` or threw). */
-    onError?: (error?: unknown) => void;
-    /**
-     * Show a `window.dialog.confirm` before calling `onReset`. @default true
-     *
-     * Requires the host to mount `<DialogProvider>` from `@djangocfg/ui-core`
-     * — it installs the `window.dialog` API used here.
-     */
-    confirm?: boolean;
-    /** Confirm dialog title. */
-    confirmTitle?: string;
-    /** Confirm dialog message. */
-    confirmMessage?: string;
-    /** Override tooltip / aria label. */
-    ariaLabel?: string;
+interface HttpTransportConfig {
+    /** Base URL without trailing slash, e.g. '/api/chat' or 'https://api.example.com/v1/chat'. */
+    baseUrl: string;
+    /** Optional slug appended/forwarded as project identifier. */
+    slug?: string;
+    /** Returns headers applied to every request — e.g. Authorization. */
+    getAuthHeader?: () => Record<string, string> | Promise<Record<string, string>>;
+    /** Default fetch timeout (per non-streaming request). */
+    timeoutMs?: number;
+    /** Override fetch implementation (useful for tests or custom retry layers). */
+    fetchImpl?: typeof fetch;
 }
+declare function createHttpTransport(config: HttpTransportConfig): ChatTransport;
+
 /**
- * Standard chat-reset action: prompts the user via `window.dialog.confirm`,
- * then runs the backend reset call through `useChatReset` so the button
- * spins while it's in flight.
+ * In-memory chat transport for stories and tests. Replays scripted replies.
+ */
+
+interface MockTransportOptions {
+    /** Each entry is the assistant's reply for one user turn. Strings are split
+     *  into chunks; arrays are taken as the exact event sequence (after a
+     *  prepended `message_start` and before a synthetic `message_end`). */
+    replies?: Array<string | ChatStreamEvent[]>;
+    latencyMs?: number;
+    /** Initial history returned by `createSession`. */
+    initialMessages?: ChatMessage[];
+    shouldFail?: (attempt: number) => boolean;
+}
+declare function createMockTransport(opts?: MockTransportOptions): ChatTransport;
+
+/**
+ * Server-Sent Events parser as an AsyncGenerator.
  *
- * @example
- * ```tsx
- * <ChatHeaderResetButton
- *   onReset={api.clearChat}
- *   onSuccess={() => chat.clearMessages()}
- * />
- * ```
+ * Yields parsed events from a `Response` body. Handles the split-read case
+ * where `event:` and `data:` arrive in separate TCP packets. Skips malformed
+ * JSON gracefully. Honors AbortSignal (caller passes one to fetch).
+ */
+
+interface RawEvent {
+    event?: string;
+    data?: string;
+}
+interface ParseSSEOptions {
+    signal?: AbortSignal;
+    /** Map a raw SSE event to zero, one, or many `ChatStreamEvent`s.
+     *  Default: parse `data` as JSON and assume the JSON shape already
+     *  matches `ChatStreamEvent`. */
+    map?: (raw: RawEvent) => ChatStreamEvent | ChatStreamEvent[] | null;
+    idleTimeoutMs?: number;
+}
+declare function parseSSE(response: Response, options?: ParseSSEOptions): AsyncGenerator<ChatStreamEvent, void, void>;
+
+/**
+ * Transport surface re-export. Lives in core so transport implementations
+ * never need to reach into the public types module.
  */
-declare function ChatHeaderResetButton({ onReset, onSuccess, onError, confirm, confirmTitle, confirmMessage, ariaLabel, }: ChatHeaderResetButtonProps): react_jsx_runtime.JSX.Element;
 
-interface ChatHeaderLanguageButtonProps {
-    /** Override aria-label. Default "Speech language". */
-    ariaLabel?: string;
-    /**
-     * Subset of BCP-47 tags to offer. Default: every entry from the
-     * Web Speech catalogue (~66 tags incl. regional variants). Pass a
-     * tighter list when your backend STT only supports a subset.
-     */
-    allowedTags?: string[];
-    /** Hide the globe-fallback icon when no flag resolves. */
-    hideFallbackIcon?: boolean;
-    className?: string;
+declare class TransportError extends Error {
+    code: string;
+    constructor(message: string, code?: string);
 }
+
 /**
- * Compact flag-button language picker for the chat header. Built on
- * top of the ui-core `<Combobox>` — searchable autocomplete with
- * flags, ~66 BCP-47 tags from the official Chrome Web Speech demo, and
- * a custom 28×28 trigger via `renderTrigger`.
+ * Pydantic-AI SSE event mapper.
  *
- * The selection persists into `useSpeechPrefs` (zustand+localStorage)
- * so `useSpeechRecognition` picks it up as the second-priority resolver
- * value (above i18n locale, below an explicit `language` prop).
+ * Translates the event shape emitted by pydantic-AI–style Django backends
+ * (text_delta / tool_call / tool_result / done / error / approval_required)
+ * into the canonical `ChatStreamEvent` stream consumed by the Chat reducer.
+ *
+ * Backends that don't expose a stable `tool_call_id` are supported via a
+ * per-stream FIFO queue keyed by tool name. The earlier "Map<name, toolId>"
+ * approach lost the first toolId when a tool was invoked twice in one turn
+ * (e.g. `list_tasks` for search and again for confirmation) — using a queue
+ * keeps each call/result pair correctly matched.
  */
-declare function ChatHeaderLanguageButton({ ariaLabel, allowedTags, hideFallbackIcon, className, }: ChatHeaderLanguageButtonProps): react.ReactElement;
 
-interface ChatGreetingProps {
-    /** Controlled visibility — usually `!chatOpen && !userDismissed`. */
-    open: boolean;
-    /** Greeting text. Pass a string for the default bubble, or any ReactNode. */
-    children: ReactNode;
-    /** Click handler — typically opens the chat. Bubble is clickable when set. */
-    onClick?: () => void;
-    /** Close (×) button handler — typically marks the greeting as dismissed. */
-    onDismiss?: () => void;
-    /** Anchor relative to a FAB on the same side. @default 'bottom-right' */
-    position?: ChatFABPosition;
-    /**
-     * Horizontal pixel offset matching the FAB's `offset` prop, so the greeting
-     * lines up under the FAB. @default 24
-     */
-    fabOffset?: number;
-    /**
-     * Vertical pixel offset above/below the FAB centerline. @default 96
-     * (room for an `md` FAB plus a small gap).
-     */
-    fabClearance?: number;
-    /** Delay before the greeting appears, in ms. @default 1500 */
-    delayMs?: number;
-    /** z-index. @default 9998 (just below the default FAB at 9999). */
-    zIndex?: number;
-    /** Override classes on the bubble. */
-    className?: string;
-    /** Override styles on the bubble. */
-    style?: CSSProperties;
-    /** Optional sender avatar / icon shown on the left. */
-    avatar?: ReactNode;
-    /** Optional sender label rendered above the text. */
-    senderName?: string;
-    /** ARIA label for the dismiss button. @default 'Dismiss' */
-    dismissLabel?: string;
+interface PydanticAIEvent {
+    type: 'text_delta' | 'tool_call' | 'tool_result' | 'done' | 'error' | 'approval_required';
+    delta?: string;
+    tool?: string;
+    args?: unknown;
+    result?: unknown;
     /**
-     * Render in-place (no fixed positioning). Useful for stories and inline previews.
-     * @default false
+     * Structured frontend payload — present on `tool_result` when the tool has
+     * a `result_schema`. The LLM sees only `result` (compact text); the
+     * frontend uses `data` to render rich UI (e.g. vehicle cards).
      */
-    inline?: boolean;
+    data?: unknown;
+    total_tokens?: number;
+    error?: string;
+    tool_call_id?: string;
+    session_id?: string;
+}
+/** Per-stream FIFO queue keyed by tool name. Created via `createToolIdQueue`. */
+interface ToolIdQueue {
+    /** Allocate a new toolId for a `tool_call` event and enqueue it under `name`. */
+    push(name: string): string;
+    /** Pop the oldest toolId for `name` (or return an orphan marker if none). */
+    shift(name: string): string;
+    /** Reset all queues (e.g. on stream close). */
+    clear(): void;
 }
+declare function createToolIdQueue(): ToolIdQueue;
 /**
- * Greeting bubble shown next to a `ChatFAB` to invite the user to start a
- * conversation (LiveChat / Intercom-style proactive prompt).
- *
- * Renders fixed-position, anchored to the same corner as the FAB. Owns its
- * own delayed-mount + presence animation. Hide on chat open and/or after
- * user dismissal.
- *
- * @example
- * ```tsx
- * const [open, setOpen] = useState(false);
- * const [dismissed, setDismissed] = useState(false);
- *
- * <ChatLauncher
- *   open={open}
- *   onOpenChange={setOpen}
- *   fab={{ variant: 'animated' }}
- *   dock={{ title: 'Support' }}
- * >
- *   <SupportChat />
- * </ChatLauncher>
+ * Translate a single pydantic-AI event into zero or more `ChatStreamEvent`s.
+ * Pass a `ToolIdQueue` shared across the lifetime of one stream so that
+ * `tool_call` / `tool_result` pairs match correctly.
+ */
+declare function mapPydanticAIEvent(ev: PydanticAIEvent, toolIds: ToolIdQueue): Generator<ChatStreamEvent>;
+/**
+ * Convenience factory: returns a `ParseSSEOptions['map']` callback that
+ * decodes raw SSE frames as `PydanticAIEvent` JSON and yields zero or
+ * more `ChatStreamEvent`s through `mapPydanticAIEvent`.
  *
- * <ChatGreeting
- *   open={!open && !dismissed}
- *   onClick={() => setOpen(true)}
- *   onDismiss={() => setDismissed(true)}
- *   senderName="Anna from Support"
- *   delayMs={2000}
- * >
- *   Hi! 👋 Got a question? I'm here to help.
- * </ChatGreeting>
- * ```
+ * Allocates an internal `ToolIdQueue` — call this once per stream.
  */
-declare function ChatGreeting({ open, children, onClick, onDismiss, position, fabOffset, fabClearance, delayMs, zIndex, className, style, avatar, senderName, dismissLabel, inline, }: ChatGreetingProps): react_jsx_runtime.JSX.Element;
+declare function createPydanticAISSEMap(): NonNullable<ParseSSEOptions['map']>;
 
-interface ChatUnreadPreviewProps {
-    /** Controlled — usually `!dockOpen && !!message`. */
-    open: boolean;
-    /** Inbound message to preview. `null` hides the bubble. */
-    message: ChatMessage | null;
-    /** Tap → open chat + mark read. */
-    onClick?: () => void;
-    /** × → mark read without opening. */
-    onDismiss?: () => void;
-    /** Anchor corner — match the FAB so the bubble sits above it. @default 'bottom-right' */
-    position?: ChatFABPosition;
-    /** Horizontal offset from screen edge, matches the FAB. @default 24 */
-    fabOffset?: number;
-    /** Vertical clearance above/below the FAB. @default 96 */
-    fabClearance?: number;
-    /** Lines of body text before ellipsis. @default 2 */
-    truncate?: number;
-    /** z-index. @default 9998 */
-    zIndex?: number;
-    /** Render in-place (stories / previews). @default false */
-    inline?: boolean;
-    /** Override classes on the bubble. */
-    className?: string;
-    /** Override styles on the bubble. */
-    style?: CSSProperties;
-    /** ARIA label for the dismiss button. @default 'Mark as read' */
-    dismissLabel?: string;
-    /** Override the avatar — defaults to derived from `message.sender`. */
-    avatar?: ReactNode;
-    /** Override the sender label — defaults to `message.sender?.name`. */
-    senderName?: string;
-}
 /**
- * Push-notification bubble next to the chat FAB.
+ * High-level transport factory for pydantic-AI–style backends.
  *
- * Shows the last inbound message while the chat is closed —
- * Intercom / LiveChat-style. Tap → open chat (host wires `onClick`).
- * Dismiss × → keep chat closed but stop nagging.
+ * Composes:
+ *   - `parseSSE` for spec-compliant SSE framing (multi-line `data:`, comments, idle timeout).
+ *   - `createPydanticAISSEMap` for normalizing pydantic-AI events into `ChatStreamEvent`.
  *
- * Pair with `useChatUnread()` (inside `<ChatProvider>`) for state.
+ * Use when your backend speaks the canonical pydantic-AI stream shape
+ * (`text_delta` / `tool_call` / `tool_result` / `done` / `error`).
+ * URL building, auth headers, history loading, and optional session
+ * bootstrapping are caller responsibilities — pass them in.
  */
-declare function ChatUnreadPreview({ open, message, onClick, onDismiss, position, fabOffset, fabClearance, truncate, zIndex, inline, className, style, dismissLabel, avatar, senderName, }: ChatUnreadPreviewProps): react_jsx_runtime.JSX.Element;
 
-interface ChatLauncherHotkey {
-    /** Key (case-sensitive single char or named like 'Escape'). */
-    key: string;
-    /** Require Cmd (mac) or Ctrl (other). */
-    meta?: boolean;
-    /** Require Shift. */
-    shift?: boolean;
-    /** Require Alt. */
-    alt?: boolean;
-}
-interface ChatLauncherGreeting extends Omit<ChatGreetingProps, 'open' | 'onClick' | 'onDismiss' | 'position' | 'fabOffset' | 'children'> {
-    /** Greeting body — string for the default style, or any ReactNode. */
-    content: ReactNode;
-    /** Persistence key for "user dismissed this greeting" in `localStorage`. Pass `null` to disable persistence. @default null */
-    dismissStorageKey?: string | null;
-    /** Hide the greeting once the user opens the chat. @default true */
-    hideOnOpen?: boolean;
-}
-interface ChatLauncherProps {
-    /** Dock contents — typically a `<Chat>` instance. */
-    children: ReactNode;
-    /** FAB customization (icon, position, label, pulse, badge, tooltip, variant, size). */
-    fab?: Omit<ChatFABProps, 'onClick'>;
-    /** Dock customization (size, title, position, transition, mobileFullscreen). */
-    dock?: Omit<ChatDockProps, 'open' | 'onClose' | 'children'>;
-    /**
-     * Proactive greeting bubble shown next to the FAB before the user opens the chat.
-     * Set to a string or full config object. Omit to disable.
-     */
-    greeting?: string | ChatLauncherGreeting;
-    /** Open/close via a keyboard shortcut. */
-    hotkey?: ChatLauncherHotkey;
-    /** Initial open state for uncontrolled mode. @default false */
-    defaultOpen?: boolean;
-    /** Controlled open state (pair with `onOpenChange`). */
-    open?: boolean;
-    /** Controlled open state setter. */
-    onOpenChange?: (open: boolean) => void;
-    /**
-     * Focus the composer textarea when the dock opens. Saves a click for
-     * every "FAB → start typing" interaction. @default true
-     */
-    autoFocusComposerOnOpen?: boolean;
-    /**
-     * Close the dock on `Escape`. Mirrors standard popover / drawer UX.
-     * Set to `false` to disable (e.g. if you want Escape to do something
-     * else inside the chat). @default true
-     */
-    closeOnEscape?: boolean;
+interface PydanticAIChatTransportOpts {
     /**
-     * Last inbound message (admin reply / system notice / agent push) the
-     * user hasn't seen yet. Drives the `<ChatUnreadPreview>` bubble next
-     * to the FAB and (by default) the FAB badge.
-     *
-     * Source it from `useChatUnread()` inside your `<ChatProvider>`.
+     * Build the SSE stream URL for a user message turn.
+     * @example (sessionId, message) => `${base}/stream?session_id=${sessionId}&message=${encodeURIComponent(message)}`
      */
-    unreadMessage?: ChatMessage | null;
+    buildStreamUrl: (sessionId: string, message: string) => string | URL;
+    /** Optional history loader. If omitted, `loadHistory` returns an empty page. */
+    loadHistory?: (sessionId: string, cursor?: string | null) => Promise<HistoryPage>;
     /**
-     * Called when the user opens the chat via FAB/preview/hotkey or
-     * dismisses the preview with ×. Wire to `useChatUnread().markRead`.
+     * Optional session bootstrap. Called from `createSession`. Useful for
+     * backends that need a `POST /sessions` round-trip or want to pre-seed
+     * history.
      */
-    onMarkRead?: () => void;
+    bootstrapSession?: (opts?: CreateSessionOptions) => Promise<SessionInfo>;
+    /** Optional session teardown. */
+    closeSession?: (sessionId: string) => Promise<void>;
     /**
-     * Customize the unread bubble (`truncate`, `dismissLabel`, …).
-     * `open`/`message`/`onClick`/`onDismiss`/`position`/`fabOffset` are
-     * wired automatically.
+     * Optional non-streaming send (for hosts that need a buffered fallback,
+     * e.g. when the user disables streaming). Defaults to throwing — most
+     * hosts only use streaming.
      */
-    unreadPreview?: Omit<ChatUnreadPreviewProps, 'open' | 'message' | 'onClick' | 'onDismiss' | 'position' | 'fabOffset'>;
+    send?: (sessionId: string, content: string, options?: SendOptions) => Promise<ChatMessage>;
+    /** Request headers (Authorization, content-type, etc.). */
+    buildHeaders?: () => HeadersInit | Promise<HeadersInit>;
+    /** Override fetch (tests, retry layers). */
+    fetchImpl?: typeof fetch;
     /**
-     * Auto-inject a mute / unmute button into the header. Pass the
-     * `useChatAudio()` (or any compatible `{ muted, toggleMute }`)
-     * instance — the launcher renders `<ChatHeaderAudioToggle>` in the
-     * header's actions slot when audio is actually configured (not silent).
-     *
-     * Hosts that manage their own header can ignore this prop and render
-     * `<ChatHeaderAudioToggle>` directly.
+     * HTTP method for the stream request. Defaults to `'POST'` with
+     * `{ content, attachments, metadata }` JSON body. Set to `'GET'` if
+     * your backend embeds the message in the URL via `buildStreamUrl`.
      */
-    audio?: {
-        muted: boolean;
-        toggleMute: () => void;
-        isSilent?: boolean;
-    } | null;
+    streamMethod?: 'GET' | 'POST';
+    /** Idle timeout for the SSE connection, in ms. Forwarded to `parseSSE`. */
+    idleTimeoutMs?: number;
     /**
-     * Suppress the auto-injected audio toggle even when `audio` is passed.
-     * @default false
+     * Side-channel for events that don't translate to `ChatStreamEvent`
+     * (e.g. `approval_required` — surfaces interactive prompts outside the
+     * normal message stream). Called synchronously while parsing the SSE
+     * frame; mutate caller-owned state, don't `await` long work here.
      */
-    hideAudioToggle?: boolean;
+    onPydanticEvent?: (event: PydanticAIEvent) => void;
 }
-/**
- * Floating chat launcher = FAB + Dock + presence + optional greeting + hotkey.
- *
- * 99% of hosts use this directly. For non-FAB triggers (e.g. an inline
- * link in the page) compose `<ChatDock>` with your own button.
- */
-declare function ChatLauncher({ children, fab, dock, greeting, hotkey, defaultOpen, open: controlledOpen, onOpenChange, autoFocusComposerOnOpen, closeOnEscape, unreadMessage, onMarkRead, unreadPreview, audio, hideAudioToggle, }: ChatLauncherProps): react_jsx_runtime.JSX.Element;
-
-type ChatPresencePhase = 'hidden' | 'entering' | 'visible' | 'leaving';
-/**
- * Presence state machine for floating popovers.
- *
- * Drives a four-phase lifecycle so enter/leave CSS transitions actually fire:
- *
- *   hidden → entering (mount, transition class starts) → visible
- *   visible → leaving (transition runs) → hidden (unmount)
- *
- * Mounting in `entering` and ticking to `visible` on the next paint is what
- * lets transition classes animate. Without it the element appears already
- * at its final state and CSS transitions never observe a change.
- *
- * @param open - controlled open state
- * @param exitDurationMs - how long the leave transition runs; should match CSS
- */
-declare function useChatPresence(open: boolean, exitDurationMs?: number): ChatPresencePhase;
+declare function createPydanticAIChatTransport(opts: PydanticAIChatTransportOpts): ChatTransport;
 
 /**
  * @deprecated Plan64. As of ui-tools 2.1.369, `<MessageList>` is
@@ -3419,6 +3417,101 @@ declare function isGeoJSONFeatureCollection(v: unknown): v is {
 };
 declare function isStringValue(v: unknown): v is string;
 
+/**
+ * Chat dev logger.
+ *
+ * A thin namespaced wrapper over `consola` that no-ops in production unless
+ * the host app explicitly opts in via `<ChatRoot debug />`. The default
+ * detection uses `isDev` from `@djangocfg/ui-core/lib/env` (NODE_ENV).
+ *
+ * Why a dedicated module: chat is async and event-heavy (bootstrap, transport,
+ * SSE chunks, tool calls, regenerate, …). Inline `console.log`s rot fast and
+ * leak into prod. A single `getChatLogger()` call gives every layer the same
+ * namespaced sub-logger and keeps zero-cost gating in one place.
+ *
+ * Sub-loggers:
+ *   bootstrap  — initial session bootstrap (createSession / loadHistory)
+ *   transport  — outbound transport calls + responses
+ *   stream     — SSE chunk / tool / message_end events
+ *   lifecycle  — sendMessage, regenerate, newSession, edits
+ *   tools      — tool_call_start / _delta / _end specifics
+ *   error      — caught errors (always emitted as `error` level)
+ */
+
+type ChatLogScope = 'bootstrap' | 'transport' | 'stream' | 'lifecycle' | 'tools' | 'error';
+interface ChatLogger {
+    bootstrap: ConsolaInstance;
+    transport: ConsolaInstance;
+    stream: ConsolaInstance;
+    lifecycle: ConsolaInstance;
+    tools: ConsolaInstance;
+    error: ConsolaInstance;
+    /** True when this logger is actually emitting (host opted in or NODE_ENV=development). */
+    enabled: boolean;
+}
+/**
+ * Get the chat logger.
+ * @param debug Explicit override from the host. `undefined` falls back to `isDev`.
+ */
+declare function getChatLogger(debug?: boolean): ChatLogger;
+
+/**
+ * sanitizeDraft — minimal pre-submit cleanup for chat-composer drafts.
+ *
+ * Mirrors the conservative behaviour ChatGPT / Claude / Telegram
+ * actually ship: clean the obvious junk the user didn't intend to
+ * send, touch nothing that *could* be intentional.
+ *
+ * **What we DO touch:**
+ *
+ *   1. Trim leading/trailing whitespace (spaces, tabs, newlines,
+ *      NBSP). The user typing `\n\n   hello   \n` meant `hello`.
+ *   2. Normalise line endings — `\r\n` / `\r` → `\n`. Pasted Windows
+ *      / old-mac text gets the same internal shape, so the LLM
+ *      tokeniser and markdown renderer see one canonical form.
+ *   3. Strip zero-width / invisible characters that web-paste
+ *      smuggles in: ZWSP (U+200B), ZWNJ (U+200C), ZWJ (U+200D),
+ *      BOM / ZWNBSP (U+FEFF). They're invisible, break LLM
+ *      tokenisation, and the user never meant to type them.
+ *
+ * **What we DO NOT touch (and why):**
+ *
+ *   - **Internal whitespace runs** (3+ spaces, tabs, blank lines).
+ *     Code indentation depends on these. ChatGPT preserves them as
+ *     typed — "  if (x):\n    return" stays four-space-indented.
+ *     Collapsing them is the path to subtly broken code snippets.
+ *
+ *   - **Bidi override marks** (U+200E LRM, U+200F RLM, U+202A..U+202E).
+ *     Legitimately used in Arabic / Hebrew / mixed-direction text.
+ *     Stripping silently breaks RTL users. If a specific deployment
+ *     wants to block them as a security measure, do it at that layer
+ *     with explicit user-visible feedback.
+ *
+ *   - **Tabs vs spaces** beyond rule 1. Could be either code or
+ *     prose; without parsing markdown we can't tell.
+ *
+ *   - **Emoji, mentions, URLs, code spans** — passthrough text.
+ *
+ * The function is intentionally tiny — every rule earns its keep
+ * with a concrete "user pasted X from Y, got nonsense" story.
+ *
+ * **Idempotent**: `sanitizeDraft(sanitizeDraft(x)) === sanitizeDraft(x)`.
+ */
+declare function sanitizeDraft(input: string): string;
+/**
+ * Convenience predicate: true when the draft is non-empty AFTER
+ * sanitation. Use to gate Send buttons / Enter submits so an empty
+ * or whitespace-only draft never produces a real message.
+ *
+ * Cheaper than sanitizeDraft(input).length > 0 only marginally —
+ * we still allocate the cleaned string. Kept as a named helper for
+ * call-site clarity.
+ */
+declare function isSubmittableDraft(input: string): boolean;
+
+/** Walk the conversation and collect image attachments in chronological order. */
+declare function collectImageAttachments(messages: ChatMessage[]): ChatAttachment[];
+
 /**
  * Chat color tokens — single source of truth.
  *
@@ -3533,100 +3626,7 @@ interface ChatDestructiveStyles {
  */
 declare function useChatDestructiveStyles(): ChatDestructiveStyles;
 
-/** Walk the conversation and collect image attachments in chronological order. */
-declare function collectImageAttachments(messages: ChatMessage[]): ChatAttachment[];
-
-/**
- * sanitizeDraft — minimal pre-submit cleanup for chat-composer drafts.
- *
- * Mirrors the conservative behaviour ChatGPT / Claude / Telegram
- * actually ship: clean the obvious junk the user didn't intend to
- * send, touch nothing that *could* be intentional.
- *
- * **What we DO touch:**
- *
- *   1. Trim leading/trailing whitespace (spaces, tabs, newlines,
- *      NBSP). The user typing `\n\n   hello   \n` meant `hello`.
- *   2. Normalise line endings — `\r\n` / `\r` → `\n`. Pasted Windows
- *      / old-mac text gets the same internal shape, so the LLM
- *      tokeniser and markdown renderer see one canonical form.
- *   3. Strip zero-width / invisible characters that web-paste
- *      smuggles in: ZWSP (U+200B), ZWNJ (U+200C), ZWJ (U+200D),
- *      BOM / ZWNBSP (U+FEFF). They're invisible, break LLM
- *      tokenisation, and the user never meant to type them.
- *
- * **What we DO NOT touch (and why):**
- *
- *   - **Internal whitespace runs** (3+ spaces, tabs, blank lines).
- *     Code indentation depends on these. ChatGPT preserves them as
- *     typed — "  if (x):\n    return" stays four-space-indented.
- *     Collapsing them is the path to subtly broken code snippets.
- *
- *   - **Bidi override marks** (U+200E LRM, U+200F RLM, U+202A..U+202E).
- *     Legitimately used in Arabic / Hebrew / mixed-direction text.
- *     Stripping silently breaks RTL users. If a specific deployment
- *     wants to block them as a security measure, do it at that layer
- *     with explicit user-visible feedback.
- *
- *   - **Tabs vs spaces** beyond rule 1. Could be either code or
- *     prose; without parsing markdown we can't tell.
- *
- *   - **Emoji, mentions, URLs, code spans** — passthrough text.
- *
- * The function is intentionally tiny — every rule earns its keep
- * with a concrete "user pasted X from Y, got nonsense" story.
- *
- * **Idempotent**: `sanitizeDraft(sanitizeDraft(x)) === sanitizeDraft(x)`.
- */
-declare function sanitizeDraft(input: string): string;
-/**
- * Convenience predicate: true when the draft is non-empty AFTER
- * sanitation. Use to gate Send buttons / Enter submits so an empty
- * or whitespace-only draft never produces a real message.
- *
- * Cheaper than sanitizeDraft(input).length > 0 only marginally —
- * we still allocate the cleaned string. Kept as a named helper for
- * call-site clarity.
- */
-declare function isSubmittableDraft(input: string): boolean;
-
-/**
- * Chat dev logger.
- *
- * A thin namespaced wrapper over `consola` that no-ops in production unless
- * the host app explicitly opts in via `<ChatRoot debug />`. The default
- * detection uses `isDev` from `@djangocfg/ui-core/lib/env` (NODE_ENV).
- *
- * Why a dedicated module: chat is async and event-heavy (bootstrap, transport,
- * SSE chunks, tool calls, regenerate, …). Inline `console.log`s rot fast and
- * leak into prod. A single `getChatLogger()` call gives every layer the same
- * namespaced sub-logger and keeps zero-cost gating in one place.
- *
- * Sub-loggers:
- *   bootstrap  — initial session bootstrap (createSession / loadHistory)
- *   transport  — outbound transport calls + responses
- *   stream     — SSE chunk / tool / message_end events
- *   lifecycle  — sendMessage, regenerate, newSession, edits
- *   tools      — tool_call_start / _delta / _end specifics
- *   error      — caught errors (always emitted as `error` level)
- */
-
-type ChatLogScope = 'bootstrap' | 'transport' | 'stream' | 'lifecycle' | 'tools' | 'error';
-interface ChatLogger {
-    bootstrap: ConsolaInstance;
-    transport: ConsolaInstance;
-    stream: ConsolaInstance;
-    lifecycle: ConsolaInstance;
-    tools: ConsolaInstance;
-    error: ConsolaInstance;
-    /** True when this logger is actually emitting (host opted in or NODE_ENV=development). */
-    enabled: boolean;
-}
-/**
- * Get the chat logger.
- * @param debug Explicit override from the host. `undefined` falls back to `isDev`.
- */
-declare function getChatLogger(debug?: boolean): ChatLogger;
+declare const LazyChat: react.ComponentType<ChatRootProps>;
 
 interface MessageListProps {
     messages?: ChatMessage[];