@elizaos/ui 2.0.0-beta.2 → 2.0.3-beta.3

package/components/shell/ContinuousChatOverlay.js

@@ -0,0 +1,2370 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { transcriptPlainText } from "@elizaos/shared/transcripts";
+import { Check, Copy, FileText, Film, LayoutGrid, Loader2, Maximize2, Mic, Minimize2, Music, RotateCcw, SendHorizontal, } from "lucide-react";
+import { AnimatePresence, animate, motion, useMotionValue, useMotionValueEvent, useReducedMotion, useTransform, } from "motion/react";
+import * as React from "react";
+import { client } from "../../api/client.js";
+import { parseSlashDraft, resolveClientShortcutExecution, runSlashExecution, splitLeadingSlashCommand, } from "../../chat/slash-menu.js";
+import { CHAT_PREFILL_EVENT, TUTORIAL_CHAT_CONTROL_EVENT, } from "../../events/index.js";
+import { Z_SHELL_OVERLAY } from "../../lib/floating-layers.js";
+import { cn } from "../../lib/utils.js";
+import { useViewChatBinding } from "../../state/view-chat-binding.js";
+import { copyTextToClipboard } from "../../utils/clipboard.js";
+import { CHAT_UPLOAD_ACCEPT, chatUploadKind, classifyComposerPaste, intakeAttachmentFiles, MAX_CHAT_IMAGES, summarizeDroppedAttachments, } from "../../utils/image-attachment.js";
+import { InlineWidgetText } from "../chat/InlineWidgetText.js";
+import { MessageAttachments } from "../chat/MessageAttachments.js";
+import { SensitiveRequestBlock } from "../chat/MessageContent.js";
+import { conversationTranscriptText } from "../chat/message-parser-helpers.js";
+import { ThinkingBlock } from "../chat/ThinkingBlock.js";
+import { withTranscriptMarker } from "../chat/TranscriptViewerOverlay.js";
+import { SlashCommandMenu, useSlashMenu } from "./SlashCommandMenu.js";
+import { selectVisibleShellMessages } from "./shell-state.js";
+import { TopicChipsBar } from "./TopicChipsBar.js";
+import { TopicGroup } from "./TopicGroup.js";
+import { deriveChannelTopics, groupMessagesByTopic } from "./topic-grouping.js";
+import { usePullGesture } from "./use-pull-gesture.js";
+import { usePromptSuggestions } from "./usePromptSuggestions.js";
+/** No-op slash controller so the overlay renders without a provider (stories). */
+const EMPTY_SLASH_CONTROLLER = {
+    commands: [],
+    loading: false,
+    naturalShortcutsEnabled: false,
+    resolveChoices: () => [],
+    resolveSection: () => undefined,
+    navigateTab: () => { },
+    navigateSettings: () => { },
+    navigateView: () => { },
+    clearChat: () => { },
+    openCommandPalette: () => { },
+};
+/**
+ * The continuous-chat overlay: one always-present, ambient glass conversation
+ * that floats over EVERY view. There are no separate chats and no switcher — it
+ * is a single endless thread (the app's one active conversation, via
+ * useShellController).
+ *
+ * Layout is a fixed composer at the bottom with a pull-up history SHEET above
+ * it. At rest the sheet is a slim peek (the grabber + the latest line); pull it
+ * UP — anywhere on the sheet — or just start typing to spring it open into the
+ * full transcript; pull the grabber back DOWN, or press Escape, to close.
+ * Nothing else dismisses it — clicking or scrolling the view behind does
+ * nothing. The composer never moves; the history slides up over it.
+ *
+ * The container is pointer-events-none (the view behind stays live); only the
+ * composer + sheet capture input, so it is non-blocking — unlike the
+ * focus-trapping AssistantOverlay it supersedes in the main shell.
+ *
+ * Two design rules keep it intimate rather than app-like:
+ *  1. SELF-CONTAINED CONTRAST — every surface carries its own dark-glass scrim
+ *     (or, for floating text, a soft shadow) plus fixed light text, never the
+ *     theme's `--txt`, so it stays legible over any substrate: a bright view, a
+ *     dark view, or the warm "good evening" backdrop.
+ *  2. NO CHROME/SIGNAGE — the thread speaks for itself: no message counter, no
+ *     "new chat", no tab strip; controls dissolve into the glass, and status is
+ *     a soft breath of light, not a brand-colored alert ring.
+ *
+ * Pure/presentational: it takes the controller as a prop so it can be rendered
+ * in isolation (stories / harness) with a mock. The app wraps it in a small
+ * context-reading mount (see App.tsx) that supplies the shared controller.
+ */
+// Floating (un-scrimmed) text gets a soft shadow so it reads over bright views.
+const FLOAT_SHADOW = "[text-shadow:0_1px_4px_rgba(0,0,0,0.7)]";
+// Shared easing for the overlay's cheap motion path. Open/close must stay
+// opacity/translate only: animating blur/filter or scaling a scrollable
+// transcript repaints too much of the viewport and visibly janks on laptops.
+const OVERLAY_EASE = [0.22, 1, 0.36, 1];
+const SHEET_HALF_VH = 0.46; // fraction of viewport height at the HALF detent
+// px kept clear above the panel. Sized to clear an edge-to-edge status bar
+// (~58px) plus a buffer so the grabber sits BELOW the notification-shade pull
+// zone — the full sheet reaches the top without fighting the system gesture.
+const SHEET_TOP_MARGIN = 72;
+// Detent magnetism: on a deliberate (non-flick) drag release, a height within
+// this many px of a detent (collapsed/half/full) snaps to that detent instead
+// of resting free — so near-detent releases are deterministic + clean, and only
+// the clear gaps between detents keep the free-drag rest height.
+const SHEET_DETENT_MAGNET = 64;
+// Feature flag: the resting one-tap prompt-suggestion strip. Off for now so the
+// composer can be tested without it; flip to true to bring the strip back.
+const SHOW_PROMPT_SUGGESTIONS = false;
+// A light iOS-style impact on each detent cross. Self-contained + guarded so it
+// is a no-op off-native (and in jsdom tests) without coupling the overlay to the
+// Capacitor bridge module. Mirrors `bridge/capacitor-bridge.ts` `haptics.light()`.
+function detentHaptic() {
+    try {
+        const cap = globalThis.Capacitor;
+        if (cap?.isNativePlatform?.()) {
+            void cap.Plugins?.Haptics?.impact?.({ style: "LIGHT" });
+        }
+    }
+    catch {
+        // Haptics are a nicety — never let them throw into the gesture path.
+    }
+}
+const SHEET_SPRING = {
+    type: "spring",
+    stiffness: 320,
+    damping: 34,
+    mass: 0.9,
+};
+// Slightly springier preset for the pill→input "liquid glass" open: a touch
+// less damping than the height spring so the input reads as springing IN on a
+// flick, while the live drag-tracking gives a slow pull its "lerp" character.
+const OPEN_SPRING = {
+    type: "spring",
+    stiffness: 300,
+    damping: 26,
+    mass: 0.85,
+};
+// Finger travel (px) that fully opens the input from the pill. A live pill drag
+// maps offset → openProgress ∈ [0,1] over this distance; past it, the excess
+// flows into the thread height so pill → input → chat is one continuous motion.
+const PILL_OPEN_DISTANCE = 120;
+// Rubber-band resistance applied to drag past a detent (iOS-style overscroll).
+function rubberBand(overshoot) {
+    return Math.sign(overshoot) * Math.sqrt(Math.abs(overshoot)) * 6;
+}
+// Glyphs (viewBox 0 0 36 36), rendered in currentColor inside a soft chip. Send
+// + mic now use lucide icons (SendHorizontal / Mic); the rest stay hand-drawn.
+const PLUS_GLYPH = "M16 8H20V16H28V20H20V28H16V20H8V16H16Z";
+// Stop generating: a centered rounded square (the universal "stop" affordance).
+const STOP_GLYPH = "M12 12H24V24H12Z";
+/** Base64-encode WAV bytes in chunks (avoids the apply() arg-count limit). */
+function wavBytesToBase64(bytes) {
+    let binary = "";
+    const chunk = 0x8000;
+    for (let i = 0; i < bytes.length; i += chunk) {
+        binary += String.fromCharCode(...Array.from(bytes.subarray(i, i + chunk)));
+    }
+    return btoa(binary);
+}
+/** UTF-8-safe base64 for a transcript turned into a composer text attachment. */
+function textToBase64(text) {
+    return wavBytesToBase64(new TextEncoder().encode(text));
+}
+// Muted-speaker glyph for the autoplay-blocked "tap to enable sound" prompt.
+const SPEAKER_MUTED_GLYPH = "M7 15H12L18 10V26L12 21H7Z M21 12.4L22.4 11L31 19.6L29.6 21Z";
+function Glyph({ d }) {
+    return (_jsx("svg", { viewBox: "0 0 36 36", className: "h-[26px] w-[26px]", "aria-hidden": "true", children: _jsx("path", { fill: "currentColor", fillRule: "evenodd", d: d }) }));
+}
+/** A soft round glass control that dissolves into the bar; brightens only when active. */
+function SoftButton({ glyph, icon: Icon, label, onClick, onPointerDown, onPointerUp, onPointerCancel, disabled, active, testId, }) {
+    return (_jsx("button", { type: "button", "data-testid": testId, "aria-label": label, "aria-pressed": active, "aria-disabled": disabled, onClick: disabled ? undefined : onClick, onPointerDown: disabled ? undefined : onPointerDown, onPointerUp: disabled ? undefined : onPointerUp, onPointerCancel: disabled ? undefined : onPointerCancel, className: cn(
+        // 44×44 hit target (WCAG 2.5.5) — comfortably thumb-tappable without
+        // crowding the bar (split the difference back down from 48).
+        "grid h-11 w-11 shrink-0 place-items-center rounded-full border transition-colors", "  ", active
+            ? "border-white/40 bg-white/85 text-black"
+            : "border-white/15 bg-white/10 text-white/75 hover:bg-white/20 hover:text-white", disabled && "opacity-40"), children: Icon ? (_jsx(Icon, { className: "h-[22px] w-[22px]", "aria-hidden": true })) : glyph ? (_jsx(Glyph, { d: glyph })) : null }));
+}
+/** A compact glass control for the full-state header (maximize / clear /
+ *  settings). Smaller than SoftButton; same neutral resting → neutral-hover
+ *  language (no blue), `active` gets the white fill. Renders a lucide icon. */
+function HeaderButton({ icon: Icon, label, onClick, active, disabled, testId, }) {
+    return (_jsx("button", { type: "button", "data-testid": testId, "aria-label": label, "aria-pressed": active, disabled: disabled, "aria-disabled": disabled || undefined, onClick: onClick, className: cn("grid h-9 w-9 shrink-0 place-items-center rounded-full border transition-colors", "  ", disabled
+            ? // On the view it targets: shown but inert + dimmed (we disable, not hide).
+                "cursor-default border-white/10 bg-white/[0.05] text-white/35"
+            : active
+                ? "border-white/40 bg-white/85 text-black"
+                : "border-white/15 bg-white/10 text-white/75 hover:bg-white/20 hover:text-white"), children: _jsx(Icon, { className: "h-[18px] w-[18px]", "aria-hidden": true }) }));
+}
+/** Horizontal travel (px) at which a conversation-swipe edge hint is fully lit. */
+const SWIPE_HINT_FULL = 96;
+/** Inert conversation-nav fallback for minimal mock controllers. */
+const EMPTY_CONVERSATION_NAV = {
+    hasPrev: false,
+    hasNext: false,
+    goPrev: () => { },
+    goNext: () => { },
+};
+/**
+ * A soft glass glow on the sheet edge the next/previous conversation will slide
+ * in from during a horizontal swipe (#8929). Brightens with the drag distance;
+ * inert and non-interactive.
+ */
+function SwipeEdgeHint({ side, active, amount, }) {
+    if (!active)
+        return null;
+    const opacity = Math.min(1, Math.max(0, amount) / SWIPE_HINT_FULL);
+    if (opacity <= 0)
+        return null;
+    return (_jsx("div", { "aria-hidden": true, "data-testid": `conversation-swipe-hint-${side}`, className: cn("pointer-events-none absolute inset-y-0 z-20 w-16", side === "left"
+            ? "left-0 bg-gradient-to-r from-white/25 to-transparent"
+            : "right-0 bg-gradient-to-l from-white/25 to-transparent"), style: { opacity } }));
+}
+/**
+ * The drag handle at the top of the chat sheet — pull UP to open the history,
+ * pull DOWN to close it. It is also keyboard-operable (Enter/Space toggles,
+ * ArrowUp opens, ArrowDown/Escape closes) so the drag-only affordance stays
+ * WCAG 2.1.1 operable. `touch-none` keeps the browser from scroll/refreshing
+ * mid-drag. A faint warm sheen rides the handle while the agent is live.
+ */
+function SheetGrabber({ open, onOpen, onClose, binding, glow, opacity, pilled, }) {
+    return (_jsx(motion.button, { style: { opacity, pointerEvents: pilled ? "none" : "auto" }, 
+        // Invisible + inert while pilled: the pill capsule below owns the drag, so
+        // keep this out of the tab order and the a11y tree until it's the handle.
+        tabIndex: pilled ? -1 : undefined, "aria-hidden": pilled || undefined, 
+        // A disclosure toggle for the chat history, not a value-bearing separator:
+        // button + aria-expanded is the accurate semantic and stays keyboard-
+        // operable (Enter/Space toggle, Arrow keys nudge) per WCAG 2.1.1.
+        type: "button", "aria-expanded": open, "aria-label": open ? "drag down to close chat" : "drag up to open chat", "data-testid": "chat-sheet-grabber", "data-open": open ? "true" : "false", onKeyDown: (e) => {
+            if (e.key === "Enter" || e.key === " ") {
+                e.preventDefault();
+                if (open)
+                    onClose();
+                else
+                    onOpen();
+            }
+            else if (e.key === "ArrowUp") {
+                e.preventDefault();
+                onOpen();
+            }
+            else if (e.key === "ArrowDown" || e.key === "Escape") {
+                e.preventDefault();
+                onClose();
+            }
+        }, ...binding, className: cn("appearance-none border-0 bg-transparent text-left", 
+        // ABSOLUTELY positioned over the panel top (zero layout height — it
+        // floats slightly on top of the input row, so collapsed height == the
+        // input bar). The bar sits a touch lower; the BIG invisible `before` hit
+        // zone reaches UP into the empty space above the panel (3× taller/wider
+        // than the bar) so it's easy to grab without covering the edge buttons.
+        // z-20 keeps it above the input row (z-10) so it always wins the drag.
+        "absolute left-1/2 top-0.5 z-20 -translate-x-1/2 flex cursor-grab touch-none select-none items-center justify-center px-16 py-1 active:cursor-grabbing", 
+        // The hit zone reaches UP into the empty space above the panel (easy to
+        // grab) and stops at the handle's own bottom — it never reaches the
+        // vertically-centered textarea, so a tap on the composer lands natively
+        // on the textarea and raises the keyboard (a programmatic focus from the
+        // handle wouldn't). Pull gestures start from the bar / the upward zone.
+        "before:absolute before:-inset-x-6 before:-top-16 before:bottom-0 before:content-['']", "   "), children: _jsx("span", { "aria-hidden": "true", className: cn(
+            // The visible grabber line. Its show/hide is driven by the WRAPPER's
+            // `grabberOpacity` crossfade (fades in over [0.55, 0.95] of the open),
+            // strictly anti-phase with the pill bar so the two are never on screen
+            // together. The bar paints at full opacity — a prior regression pinned
+            // it to `opacity-0`, leaving the handle grabbable but invisible (#9142).
+            "h-2.5 w-16 rounded-full opacity-100 transition-colors duration-300", glow ? "bg-[rgba(255,180,120,0.8)]" : "bg-white/45") }) }));
+}
+/**
+ * The fully-collapsed PILL — the chat reduced to a small glass capsule at the
+ * very bottom. Tap or flick/pull it up to bring the input back. Big invisible
+ * hit area so it's easy to grab; the visible capsule stays small.
+ */
+function PillHandle({ binding, onOpen, glow, pilled, }) {
+    return (_jsx("button", { type: "button", "data-testid": "chat-pill", "aria-label": "open chat", 
+        // No onClick: the pull-gesture binding is the single tap authority (a tap
+        // routes through onPointerUp → onTap → openFromPill), matching the
+        // SheetGrabber. A native onClick would ALSO fire on every tap, opening the
+        // pill twice in one gesture (double haptic + a stale focus-suppress flag
+        // that swallowed the next focus→expand). Keyboard activation still routes
+        // through onKeyDown below.
+        onKeyDown: (e) => {
+            if (e.key === "Enter" || e.key === " " || e.key === "ArrowUp") {
+                e.preventDefault();
+                onOpen();
+            }
+        }, ...binding, tabIndex: pilled ? undefined : -1, "aria-hidden": pilled ? undefined : true, className: cn(
+        // The bar hugs the BOTTOM (small pb) where the collapsed input sat — not
+        // floating mid-air; the tall pt keeps a generous upward grab/flick zone.
+        "flex cursor-grab touch-none select-none items-end justify-center px-16 pb-1.5 pt-10 active:cursor-grabbing", 
+        // Interactive only while pilled. When NOT pilled the (faded) handle must
+        // let taps fall through to the composer textarea below it — otherwise its
+        // tall hit zone steals the tap and the keyboard never opens.
+        pilled ? "pointer-events-auto" : "pointer-events-none", "   "), children: _jsx("span", { "aria-hidden": "true", className: cn(
+            // Identical to the SheetGrabber bar — same white shape + color whether
+            // the chat is open or collapsed to the pill. Its show/hide is driven by
+            // the WRAPPER's `pillOpacity` crossfade (anti-phase with the grabber).
+            // The bar paints at full opacity — a prior regression pinned it to
+            // `opacity-0`, leaving the pill handle grabbable but invisible (#9142).
+            "h-2.5 w-16 rounded-full opacity-100 transition-colors duration-300", glow ? "bg-[rgba(255,180,120,0.8)]" : "bg-white/45") }) }));
+}
+/** Humanize an action/tool symbol ("SEND_MESSAGE" → "Send message") for the
+ *  status label so it reads as prose, not a constant. */
+function humanizeStatusName(name) {
+    const cleaned = name.trim().replace(/[_-]+/g, " ").toLowerCase();
+    if (!cleaned)
+        return "";
+    return cleaned.charAt(0).toUpperCase() + cleaned.slice(1);
+}
+/** The phase label shown beside the breathing dots. Server-provided `label`
+ *  always wins; otherwise derive a concise phrase from the kind (+ action/tool
+ *  name when present). */
+function turnStatusLabel(status) {
+    if (status.label?.trim())
+        return status.label.trim();
+    switch (status.kind) {
+        case "thinking":
+            return "Thinking";
+        case "streaming":
+            return "Replying";
+        case "running_action":
+            return status.actionName
+                ? `Running ${humanizeStatusName(status.actionName)}`
+                : "Working";
+        case "running_tool":
+            return status.toolName
+                ? `Using ${humanizeStatusName(status.toolName)}`
+                : "Using a tool";
+        case "evaluating":
+            return "Reflecting";
+        case "waking":
+            return "Waking the agent";
+        case "speaking":
+            return "Speaking";
+    }
+}
+// Min time (ms) a phase label must stay on screen before the next one replaces
+// it. Without this, a fast thinking→action→streaming sequence flickers through
+// labels faster than the eye can read. The text content the user sees is
+// debounced; the dots animate continuously throughout.
+const STATUS_MIN_DWELL_MS = 320;
+/** Debounce a fast-changing status to a min on-screen dwell so a rapid
+ *  thinking→action→streaming sequence doesn't strobe the label. The dots animate
+ *  continuously; only the words wait their turn. Returns null when status is
+ *  null (between turns). */
+function useDebouncedTurnStatus(status) {
+    const [shown, setShown] = React.useState(status);
+    const lastChangeRef = React.useRef(0);
+    const timerRef = React.useRef(null);
+    React.useEffect(() => {
+        if (!status) {
+            setShown(null);
+            return;
+        }
+        const now = Date.now();
+        const elapsed = now - lastChangeRef.current;
+        if (elapsed >= STATUS_MIN_DWELL_MS) {
+            lastChangeRef.current = now;
+            setShown(status);
+            return;
+        }
+        if (timerRef.current !== null)
+            window.clearTimeout(timerRef.current);
+        timerRef.current = window.setTimeout(() => {
+            lastChangeRef.current = Date.now();
+            setShown(status);
+            timerRef.current = null;
+        }, STATUS_MIN_DWELL_MS - elapsed);
+        return () => {
+            if (timerRef.current !== null) {
+                window.clearTimeout(timerRef.current);
+                timerRef.current = null;
+            }
+        };
+    }, [status]);
+    return shown;
+}
+/**
+ * The breathing dots + phase label content of the status indicator, WITHOUT a
+ * bubble/motion wrapper — used both standalone (wrapped by TurnStatusIndicator)
+ * and inline inside the in-flight assistant bubble.
+ *
+ * Mirrors ChatVoiceStatusBar's a11y (`role="status"` + `aria-live="polite"`).
+ * Honors reduced motion (no pulse). Brand-safe: orange (the accent) ONLY for
+ * `speaking`; every other phase is neutral white. No blue anywhere. Degrades to
+ * plain dots when no status has arrived.
+ */
+function TurnStatusInner({ status, }) {
+    const shown = useDebouncedTurnStatus(status);
+    const speaking = shown?.kind === "speaking";
+    const label = shown ? turnStatusLabel(shown) : null;
+    return (_jsxs("span", { className: "inline-flex items-center gap-2", "data-testid": "turn-status-indicator", "data-status-kind": shown?.kind ?? "none", role: "status", "aria-live": "polite", children: [_jsx("span", { className: "flex gap-1.5", "data-testid": "typing-dots", "aria-hidden": "true", children: [0, 1, 2].map((i) => (_jsx("span", { className: cn("h-1.5 w-1.5 animate-pulse rounded-full motion-reduce:animate-none", speaking ? "bg-[rgba(255,190,140,0.9)]" : "bg-white/70"), style: { animationDelay: `${i * 180}ms` } }, i))) }), label ? (_jsx("span", { className: cn("text-[13px] font-medium", speaking ? "text-[rgba(255,200,150,0.95)]" : "text-white/90"), "data-testid": "turn-status-label", children: label })) : null] }));
+}
+/**
+ * The rich, phase-aware status row shown while the assistant works (#8813),
+ * replacing the bare typing dots in the pre-placeholder gap. Wraps
+ * TurnStatusInner in its own glass bubble + fade so it reads as a turn.
+ */
+function TurnStatusIndicator({ status, reduce, }) {
+    const speaking = status?.kind === "speaking";
+    return (_jsx(motion.div, { className: "mb-2.5 flex w-full justify-start", 
+        // Fade in/out so the row dissolves with the reply rather than popping.
+        initial: { opacity: 0 }, animate: { opacity: 1 }, exit: { opacity: 0 }, transition: { duration: reduce ? 0 : 0.45, ease: OVERLAY_EASE }, children: _jsx("div", { className: cn("rounded-2xl rounded-bl-md border px-3.5 py-2", FLOAT_SHADOW, 
+            // Orange (the accent) ONLY for spoken replies; every other phase is
+            // neutral white glass. No blue anywhere.
+            speaking
+                ? "border-[rgba(255,180,120,0.45)] bg-black/55"
+                : "border-white/10 bg-black/45"), children: _jsx(TurnStatusInner, { status: status }) }) }));
+}
+/**
+ * One turn of the transcript as a chat bubble — assistant on the left, user on
+ * the right. Memoized so a live drag (which re-renders the overlay on every
+ * pointer-move frame) doesn't re-render every message in a long thread.
+ */
+// Press-and-hold copy: a still hold this long fires; any finger travel past the
+// move threshold first cancels it (so it yields to the thread's scroll).
+const COPY_HOLD_MS = 420;
+const COPY_MOVE_CANCEL_PX = 10;
+/**
+ * Render a user turn's text, bolding a leading slash command so a sent
+ * `/command` reads as a command in the transcript (mirroring the composer's
+ * inline autocomplete). Plain prose renders unchanged.
+ */
+function ThreadLineText({ content }) {
+    const slash = splitLeadingSlashCommand(content);
+    if (!slash)
+        return content;
+    return (_jsxs(_Fragment, { children: [_jsx("span", { className: "font-bold", "data-testid": "slash-command-token", children: slash.command }), slash.rest] }));
+}
+const ThreadLine = React.memo(function ThreadLine({ message, floating, reduce, onCopy, onOpenSettings, turnStatus, }) {
+    const isUser = message.role === "user";
+    const isAssistant = message.role === "assistant";
+    // Press-and-hold to copy an assistant answer — the only extraction affordance
+    // on touch (no hover row). A still hold past COPY_HOLD_MS copies + flashes
+    // "Copied" + a light haptic; real finger travel cancels so it never fights the
+    // thread's touch-pan-y scroll.
+    const [copied, setCopied] = React.useState(false);
+    const holdTimer = React.useRef(null);
+    const holdStart = React.useRef(null);
+    const copiedTimer = React.useRef(null);
+    const clearHold = React.useCallback(() => {
+        if (holdTimer.current !== null) {
+            window.clearTimeout(holdTimer.current);
+            holdTimer.current = null;
+        }
+        holdStart.current = null;
+    }, []);
+    React.useEffect(() => () => {
+        if (holdTimer.current !== null)
+            window.clearTimeout(holdTimer.current);
+        if (copiedTimer.current !== null)
+            window.clearTimeout(copiedTimer.current);
+    }, []);
+    const canCopy = isAssistant && !!onCopy && message.content.trim().length > 0;
+    const copyHandlers = canCopy
+        ? {
+            onPointerDown: (e) => {
+                holdStart.current = { x: e.clientX, y: e.clientY };
+                holdTimer.current = window.setTimeout(() => {
+                    onCopy?.(message.content);
+                    detentHaptic();
+                    setCopied(true);
+                    if (copiedTimer.current !== null)
+                        window.clearTimeout(copiedTimer.current);
+                    copiedTimer.current = window.setTimeout(() => setCopied(false), 1100);
+                    holdTimer.current = null;
+                }, COPY_HOLD_MS);
+            },
+            onPointerMove: (e) => {
+                const s = holdStart.current;
+                if (!s)
+                    return;
+                if (Math.abs(e.clientX - s.x) > COPY_MOVE_CANCEL_PX ||
+                    Math.abs(e.clientY - s.y) > COPY_MOVE_CANCEL_PX)
+                    clearHold();
+            },
+            onPointerUp: clearHold,
+            onPointerCancel: clearHold,
+        }
+        : null;
+    // A failed turn the user can't recover from without wiring a provider: render
+    // a structured gate (not the raw error text) with a one-tap jump to Settings.
+    if (isAssistant && message.failureKind === "no_provider") {
+        return (_jsx(motion.div, { "data-testid": "thread-line", "data-role": message.role, "data-failure": "no_provider", initial: reduce ? { opacity: 0 } : { opacity: 0, y: 14 }, animate: reduce ? { opacity: 1 } : { opacity: 1, y: 0 }, exit: reduce ? { opacity: 0 } : { opacity: 0, y: -8 }, transition: { duration: reduce ? 0.15 : 0.52, ease: OVERLAY_EASE }, className: cn("flex w-full justify-start", floating ? "mb-1.5" : "mb-2.5"), children: _jsxs("div", { className: cn("max-w-[85%] rounded-2xl rounded-bl-md border border-amber-300/30 bg-black/60 px-3.5 py-3 text-white", FLOAT_SHADOW), children: [_jsx("div", { className: "mb-1 text-[14px] font-medium", children: "Connect a provider to chat" }), _jsx("div", { className: "mb-2.5 whitespace-pre-wrap text-[13px] leading-relaxed text-white/80 [overflow-wrap:anywhere]", children: message.content }), _jsx("button", { type: "button", "data-testid": "chat-no-provider-settings", onClick: () => onOpenSettings?.(), className: "rounded-full border border-white/20 bg-white/15 px-3 py-1.5 text-[13px] font-medium text-white transition-colors hover:bg-white/25   ", children: "Open Settings" })] }) }));
+    }
+    return (_jsx(motion.div, { "data-testid": "thread-line", "data-role": message.role, 
+        // New turns rise+fade in. Transform/opacity only; reduced motion collapses
+        // it to a quick fade with no positional movement.
+        initial: reduce ? { opacity: 0 } : { opacity: 0, y: 14 }, animate: reduce ? { opacity: 1 } : { opacity: 1, y: 0 }, exit: reduce ? { opacity: 0 } : { opacity: 0, y: -8 }, transition: { duration: reduce ? 0.15 : 0.52, ease: OVERLAY_EASE }, className: cn("flex w-full", floating ? "mb-1.5" : "mb-2.5", isUser ? "justify-end" : "justify-start"), children: _jsxs("div", { ...(copyHandlers ?? {}), className: cn(
+            // whitespace-pre-wrap keeps newlines; overflow-wrap breaks long URLs /
+            // hashes / paths so they can't blow out the bubble width on a phone.
+            "relative max-w-[80%] whitespace-pre-wrap rounded-2xl px-3.5 py-2 text-[14px] leading-relaxed [overflow-wrap:anywhere]", 
+            // The chrome-free transcript renders floating: each bubble carries its
+            // own dark glass so it stays legible directly over whatever view is
+            // behind. The light tone is for any embedding that supplies its own
+            // surrounding scrim.
+            isUser ? "rounded-br-md" : "rounded-bl-md", 
+            // Message text must remain selectable for normal highlight/copy.
+            // Assistant bubbles still keep the press-and-hold copy shortcut.
+            "select-text [-webkit-touch-callout:default]", floating
+                ? cn("border", isUser
+                    ? "border-white/15 bg-black/55 text-white"
+                    : "border-white/10 bg-black/45 text-white/90", FLOAT_SHADOW)
+                : isUser
+                    ? "bg-white/20 text-white"
+                    : "bg-white/10 text-white/90"), children: [_jsx("div", { "data-chat-selectable": "true", children: isAssistant &&
+                        !message.content.trim() &&
+                        !message.attachments?.length ? (_jsxs(_Fragment, { children: [_jsx(TurnStatusInner, { status: turnStatus ?? null }), message.attachments?.length ? (_jsx(MessageAttachments, { attachments: message.attachments })) : null] })) : isUser ? (_jsxs(_Fragment, { children: [_jsx(ThreadLineText, { content: message.content }), message.attachments?.length ? (_jsx(MessageAttachments, { attachments: message.attachments })) : null] })) : (_jsxs(_Fragment, { children: [_jsx(InlineWidgetText, { content: message.content }), message.attachments?.length ? (_jsx(MessageAttachments, { attachments: message.attachments })) : null, message.secretRequest ? (_jsx("div", { className: "pointer-events-auto", children: _jsx(SensitiveRequestBlock, { request: message.secretRequest }) })) : null, message.reasoning?.trim() ? (_jsx(ThinkingBlock, { reasoning: message.reasoning })) : null] })) }), _jsx(AnimatePresence, { children: copied ? (_jsx(motion.span, { "data-testid": "thread-line-copied", initial: reduce ? { opacity: 0 } : { opacity: 0, y: 4 }, animate: { opacity: 1, y: 0 }, exit: { opacity: 0 }, transition: { duration: reduce ? 0 : 0.18 }, className: "pointer-events-none absolute -top-2 right-2 rounded-full bg-white/90 px-2 py-0.5 text-[11px] font-medium text-black", children: "Copied" }, "copied")) : null })] }) }));
+});
+export function ContinuousChatOverlay({ controller, agentName = "Eliza", slash: slashProp, }) {
+    const { messages, phase, responding, turnStatus, send, canSend, recording, startRecording, stopRecording, handsFree, toggleHandsFree, transcriptionMode, toggleTranscriptionMode, stopTranscriptionAndMic, setDictationSink, setTranscriptSessionSink, setComposerHasDraft, transcript, needsAudioUnlock, unlockAudio, openSettings, navigateHome, currentTab, clearConversation, stop, modelStatus, } = controller;
+    // Defensive default so a minimal mock controller (stories/tests) that predates
+    // the swipe-nav surface still renders without crashing.
+    const conversationNav = controller.conversationNav ?? EMPTY_CONVERSATION_NAV;
+    // True while a clear/swipe is fetching an uncached thread — gates the empty
+    // thread's loading spinner. Defaulted for minimal mock controllers.
+    const conversationLoading = controller.conversationLoading ?? false;
+    // Horizontal swipe between conversations (#8929). `swipeDx` is the live
+    // horizontal drag (+left toward the next/older chat, -right toward the
+    // newer/previous chat) and drives the edge hint. The gesture defers pointer
+    // capture until a horizontal commit, so vertical thread scrolling is
+    // unaffected; it is only bound while the sheet is open (below).
+    const [swipeDx, setSwipeDx] = React.useState(0);
+    const conversationSwipe = usePullGesture({
+        onDragX: setSwipeDx,
+        onSwipeLeft: () => {
+            setSwipeDx(0);
+            conversationNav.goNext();
+        },
+        onSwipeRight: () => {
+            setSwipeDx(0);
+            conversationNav.goPrev();
+        },
+    });
+    // Copy an assistant answer (press-and-hold on its bubble). Stable identity so
+    // the memoized ThreadLine isn't re-rendered every parent tick.
+    const handleCopyMessage = React.useCallback((text) => {
+        void copyTextToClipboard(text);
+    }, []);
+    const slash = slashProp ?? EMPTY_SLASH_CONTROLLER;
+    // Honor the OS "reduce motion" setting: every overlay animation collapses to
+    // a near-instant cross-fade with no positional movement when this is true.
+    const reduce = useReducedMotion() ?? false;
+    const [draft, setDraft] = React.useState("");
+    // The active view can take over the composer: override the placeholder and
+    // receive the live draft (e.g. Help uses the chat as its search box).
+    const viewChatBinding = useViewChatBinding();
+    // Escape dismisses the slash menu without clearing the draft; typing reopens.
+    const [slashDismissed, setSlashDismissed] = React.useState(false);
+    // The chat-history sheet: closed (a slim peek + grabber) ↔ open (full
+    // scrollable history). The ONLY open/close driver — opened by a pull-up drag,
+    // by focusing the composer, or by sending; closed by a pull-down drag or
+    // Escape. Never by click-out, scroll, or blur.
+    // The sheet's vertical position is ONE ordinal — the single source of truth for
+    // how far the chat is open: `input` (composer-only peek) → `half` (reading
+    // height) → `full` (near-fullscreen). `sheetOpen`/`expanded` are derived
+    // read-only views so the two can never disagree (no impossible "open but not
+    // open" combos). `pilled` sits BELOW input; `maximized` drops the inset at full.
+    // Grabber pulls step through the detents (each cross haptics); programmatic
+    // opens (send/focus) go full.
+    // ONE openness state machine (see ChatMode). pilled / sheetOpen / expanded /
+    // detent are all DERIVED from it — so the impossible "open but not open" or
+    // pilled-and-full combos can't exist and no transition has to hand-sync two
+    // separate states (which is what bred the old stuck states).
+    const [mode, setMode] = React.useState("input");
+    const pilled = mode === "pill";
+    const sheetOpen = mode === "half" || mode === "full";
+    const expanded = mode === "full";
+    // Free-drag rest height (px): when set, the sheet rests exactly where the user
+    // released a deliberate drag instead of snapping to a detent. Cleared whenever
+    // a detent is taken (tap/flick/focus/collapse) so the detents stay the
+    // snap-to targets and free-positioning is purely the drag affordance.
+    const [freeH, setFreeH] = React.useState(null);
+    // FULL-SCREEN (maximized): at the FULL detent the user can drop the inset
+    // (max-width, side padding, top margin, rounding) so the chat is edge-to-edge.
+    // Invariant: only true while at FULL (sheetOpen && expanded && !pilled); every
+    // leave-full transition resets it.
+    const [maximized, setMaximized] = React.useState(false);
+    // Whether the sheet was collapsed when the composer last gained focus — so
+    // dismissing the keyboard (tap the handle, tap the scrim, tap outside) returns
+    // to the prior resting state (collapsed → input) instead of leaving the sheet
+    // hanging open, while a sheet that was ALREADY open before focus stays open.
+    const preFocusCollapsedRef = React.useRef(true);
+    // Snapshot of "was the composer focused (keyboard up) at the last pointerdown".
+    // The browser can auto-blur the input between a scrim pointerdown and its
+    // click, so the scrim's click handler can't read live focus — it reads this to
+    // tell a FIRST tap (keyboard up → just dismiss + restore) from a SECOND tap
+    // (keyboard already down → close the chat).
+    const composerFocusedAtPressRef = React.useRef(false);
+    // Composer focus ⟺ the soft keyboard is up on mobile. This is the reliable
+    // keyboard signal: Capacitor's resize:"body" shrinks innerHeight too, so a
+    // visualViewport-derived keyboardInset reads 0 and can't gate the layout.
+    const [composerFocused, setComposerFocused] = React.useState(false);
+    // The live thread (history) height in px, as a MOTION VALUE — driven directly
+    // by the pointer during a drag and spring-animated to a detent on release.
+    // Keeping it off React state means a drag updates the DOM height every frame
+    // with NO component re-render, so the gesture stays buttery. `draggingRef`
+    // gates the settle effect so it doesn't fight an in-flight finger drag.
+    const threadHeight = useMotionValue(0);
+    // Pill → input morph progress (0 = pill capsule, 1 = full input bar), OFF React
+    // state like threadHeight so a pill drag morphs the glass at 60fps with no
+    // re-render. Drives the glass/content crossfade + scale; `threadHeight` stays
+    // 0 until the input is fully formed, then takes over for input → chat.
+    const openProgress = useMotionValue(pilled ? 0 : 1);
+    // Imperative animations triggered from gesture callbacks are outside React's
+    // effect cleanup, so keep one owner per motion value and stop stale springs
+    // before starting another.
+    const threadAnimationRef = React.useRef(null);
+    const openProgressAnimationRef = React.useRef(null);
+    const delayedNavigationTimerRef = React.useRef(null);
+    const prefillFocusFrameRef = React.useRef(null);
+    const prefillFocusTimerRef = React.useRef(null);
+    const stopThreadAnimation = React.useCallback(() => {
+        threadAnimationRef.current?.stop();
+        threadAnimationRef.current = null;
+    }, []);
+    const stopOpenProgressAnimation = React.useCallback(() => {
+        openProgressAnimationRef.current?.stop();
+        openProgressAnimationRef.current = null;
+    }, []);
+    const animateThreadHeight = React.useCallback((target) => {
+        stopThreadAnimation();
+        threadAnimationRef.current = animate(threadHeight, target, SHEET_SPRING);
+    }, [stopThreadAnimation, threadHeight]);
+    const animateOpenProgress = React.useCallback((target) => {
+        stopOpenProgressAnimation();
+        openProgressAnimationRef.current = animate(openProgress, target, OPEN_SPRING);
+    }, [openProgress, stopOpenProgressAnimation]);
+    const clearPrefillFocusSchedule = React.useCallback(() => {
+        if (prefillFocusFrameRef.current !== null &&
+            typeof window !== "undefined" &&
+            typeof window.cancelAnimationFrame === "function") {
+            window.cancelAnimationFrame(prefillFocusFrameRef.current);
+        }
+        if (prefillFocusTimerRef.current !== null &&
+            typeof window !== "undefined") {
+            window.clearTimeout(prefillFocusTimerRef.current);
+        }
+        prefillFocusFrameRef.current = null;
+        prefillFocusTimerRef.current = null;
+    }, []);
+    React.useEffect(() => () => {
+        stopThreadAnimation();
+        stopOpenProgressAnimation();
+        if (delayedNavigationTimerRef.current !== null) {
+            window.clearTimeout(delayedNavigationTimerRef.current);
+            delayedNavigationTimerRef.current = null;
+        }
+        clearPrefillFocusSchedule();
+    }, [stopThreadAnimation, stopOpenProgressAnimation, clearPrefillFocusSchedule]);
+    // Latest `settleDrag` (defined below) exposed to the viewport-resize effect
+    // (which runs earlier). A rotation can orphan an in-flight drag — re-settling
+    // the morph keeps the pill↔input crossfade from stranding both bars visible.
+    const settleDragRef = React.useRef(null);
+    const draggingRef = React.useRef(false);
+    // Push-to-talk phase (single source of truth) + a label-only mirror.
+    const pttRef = React.useRef({ kind: "idle" });
+    const [pttHolding, setPttHolding] = React.useState(false);
+    // Swallow exactly the one click that follows a held PTT release.
+    const suppressNextClickRef = React.useRef(false);
+    const [pendingImages, setPendingImages] = React.useState([]);
+    const [imageError, setImageError] = React.useState(null);
+    const endRef = React.useRef(null);
+    const inputRef = React.useRef(null);
+    const fileInputRef = React.useRef(null);
+    const overlayRef = React.useRef(null);
+    const panelRef = React.useRef(null);
+    const threadRef = React.useRef(null);
+    // The composer content (textarea + thread). Held so we can imperatively clear
+    // its `inert` (set while pilled) the instant the pill is tapped open, before
+    // React re-renders — iOS only raises the keyboard for a focus() that lands on
+    // a non-inert element synchronously inside the originating tap gesture.
+    const contentRef = React.useRef(null);
+    // Set for one focus() when we open the pill to the bare input bar: that focus
+    // is only there to raise the iOS keyboard and must NOT trip the focus→expand
+    // that the normal "tap the visible composer" path relies on (which would
+    // fling a history thread open to half instead of resting on the input bar).
+    const suppressExpandOnFocusRef = React.useRef(false);
+    const focusThreadRef = React.useRef(false);
+    // Recomputed only when the thread or phase changes — NOT on every drag/draft
+    // re-render. Pure windowing (empty-turn filter + most-recent cap, with the
+    // streaming-assistant exception) lives in shell-state so it's unit-tested.
+    const visibleMessages = React.useMemo(() => selectVisibleShellMessages(messages, phase), [messages, phase]);
+    const lastId = visibleMessages.at(-1)?.id ?? null;
+    const lastContent = visibleMessages.at(-1)?.content ?? "";
+    // Copy the whole thread as a plain-text transcript from the full-state header
+    // — parity with the desktop ChatView header. Flashes a check on success.
+    const [conversationCopied, setConversationCopied] = React.useState(false);
+    const conversationCopiedTimerRef = React.useRef(null);
+    React.useEffect(() => () => {
+        if (conversationCopiedTimerRef.current) {
+            clearTimeout(conversationCopiedTimerRef.current);
+        }
+    }, []);
+    const handleCopyConversation = React.useCallback(() => {
+        const transcript = conversationTranscriptText(visibleMessages.map((m) => ({ role: m.role, text: m.content })), { agentName });
+        if (!transcript)
+            return;
+        void copyTextToClipboard(transcript);
+        setConversationCopied(true);
+        if (conversationCopiedTimerRef.current) {
+            clearTimeout(conversationCopiedTimerRef.current);
+        }
+        conversationCopiedTimerRef.current = setTimeout(() => setConversationCopied(false), 2000);
+    }, [agentName, visibleMessages]);
+    // The last line id the scroll effect pinned to — lets it tell a NEW line
+    // (always pin to bottom) from streaming growth of the current line (follow
+    // only when the reader is already at the bottom).
+    const scrollPinnedIdRef = React.useRef(lastId);
+    // Topic grouping + chips bar (#8928). Derived from the per-message Stage-1
+    // topic tags; when no message is tagged the transcript renders flat (the
+    // chips bar and groups simply don't appear), preserving the prior behavior.
+    const channelTopics = React.useMemo(() => deriveChannelTopics(visibleMessages), [visibleMessages]);
+    const topicSegments = React.useMemo(() => groupMessagesByTopic(visibleMessages), [visibleMessages]);
+    const hasTopics = channelTopics.length > 0;
+    const [collapsedTopics, setCollapsedTopics] = React.useState(() => new Set());
+    const setTopicCollapsed = React.useCallback((key, collapsed) => {
+        setCollapsedTopics((prev) => {
+            if (collapsed === prev.has(key))
+                return prev;
+            const next = new Set(prev);
+            if (collapsed)
+                next.add(key);
+            else
+                next.delete(key);
+            return next;
+        });
+    }, []);
+    // Tapping a chip expands its group and scrolls its header into view.
+    const scrollToTopic = React.useCallback((topic) => {
+        setCollapsedTopics((prev) => {
+            if (!prev.has(topic))
+                return prev;
+            const next = new Set(prev);
+            next.delete(topic);
+            return next;
+        });
+        if (typeof requestAnimationFrame === "undefined")
+            return;
+        requestAnimationFrame(() => {
+            const escaped = typeof CSS !== "undefined" && typeof CSS.escape === "function"
+                ? CSS.escape(topic)
+                : topic.replace(/"/g, '\\"');
+            const el = threadRef.current?.querySelector(`[data-topic="${escaped}"]`);
+            el?.scrollIntoView({ behavior: "smooth", block: "start" });
+        });
+    }, []);
+    // Render one transcript line; shared by the flat and topic-grouped paths so
+    // the in-flight-turn detection stays identical.
+    const renderThreadLine = React.useCallback((m, index) => {
+        const isInFlight = index === visibleMessages.length - 1 &&
+            m.role === "assistant" &&
+            !m.content.trim();
+        return (_jsx(ThreadLine, { message: m, floating: true, reduce: reduce, onCopy: handleCopyMessage, onOpenSettings: openSettings, turnStatus: isInFlight ? turnStatus : undefined }, m.id));
+    }, [
+        visibleMessages.length,
+        reduce,
+        handleCopyMessage,
+        openSettings,
+        turnStatus,
+    ]);
+    const booting = phase === "booting";
+    const listening = phase === "listening";
+    const hasDraft = draft.trim().length > 0;
+    const hasImages = pendingImages.length > 0;
+    // The suggestion strip is a keyboard-style row of one-tap prompts shown in the
+    // RESTING (closed) state — ready, nothing typed or attached, not recording. It
+    // unmounts once the sheet opens or a draft starts; this condition also gates
+    // the small-model fetch so it isn't called for a hidden strip.
+    const suggestionsVisible = SHOW_PROMPT_SUGGESTIONS &&
+        !pilled &&
+        !sheetOpen &&
+        !recording &&
+        !booting &&
+        canSend &&
+        !hasDraft &&
+        !hasImages;
+    // Three tailored prompt suggestions for the resting overlay (model-backed via
+    // TEXT_SMALL, with a static offline fallback).
+    const suggestions = usePromptSuggestions(messages, {
+        enabled: suggestionsVisible,
+    });
+    // Defensive unmount: clear a pending timer and stop a stuck dictation capture
+    // if the overlay unmounts mid-press (the controller outlives the overlay).
+    // biome-ignore lint/correctness/useExhaustiveDependencies: stopRecording is stable; this runs once on unmount
+    React.useEffect(() => () => {
+        const phase = pttRef.current;
+        if (phase.kind === "pending")
+            window.clearTimeout(phase.timer);
+        if (phase.kind === "holding")
+            stopRecording();
+        pttRef.current = { kind: "idle" };
+        suppressNextClickRef.current = false;
+    }, []);
+    // Keep the transcript pinned to the latest line. On first open jump INSTANTLY
+    // to the bottom — a layout effect runs before paint, so the thread never
+    // flashes at the top. A NEW line (the user's own send, or a fresh reply)
+    // always re-pins to the bottom; streaming growth of the current line follows
+    // only when the reader is already resting at the bottom, so scrolling up to
+    // read history is never yanked down.
+    const wasOpenRef = React.useRef(false);
+    // Coalesces the per-token streaming-follow scroll into one rAF so a burst of
+    // tokens landing within a frame triggers at most one measure+write instead of
+    // a forced reflow per token. New-line / first-open pins stay synchronous below.
+    const followRafRef = React.useRef(null);
+    React.useEffect(() => () => {
+        if (followRafRef.current != null)
+            cancelAnimationFrame(followRafRef.current);
+    }, []);
+    // biome-ignore lint/correctness/useExhaustiveDependencies: lastId/lastContent/sheetOpen are the triggers; the body reads refs
+    React.useLayoutEffect(() => {
+        const el = threadRef.current;
+        if (!el)
+            return;
+        const isNewLine = lastId !== scrollPinnedIdRef.current;
+        scrollPinnedIdRef.current = lastId;
+        // CLOSED peek: always pin to the bottom so it whispers the LATEST line (the
+        // one nearest the composer) — even though it can't be user-scrolled, the
+        // clipped content must show the end of the thread, not the top.
+        if (!sheetOpen) {
+            wasOpenRef.current = false;
+            el.scrollTop = el.scrollHeight;
+            return;
+        }
+        // OPEN: jump to the bottom on first open; a NEW line re-pins (smooth); while
+        // already resting at the bottom, follow streaming growth — but never yank a
+        // reader who has scrolled up to read history. Direct scrollTop assignment is
+        // more reliable than scrollIntoView inside this clipped flex column.
+        const justOpened = !wasOpenRef.current;
+        wasOpenRef.current = true;
+        // New line or first open: pin synchronously (pre-paint) so the thread never
+        // flashes at the top. Infrequent — once per turn, not per token.
+        if (isNewLine || justOpened) {
+            const atBottom = el.scrollHeight - el.scrollTop - el.clientHeight < 80;
+            // Pin to the latest line ONLY on first open, or when the reader is already
+            // resting at the bottom. If they have scrolled UP to read history, a new
+            // line must NOT yank them down — the previous code force-pinned on every
+            // new line (the `else` ran whenever !atBottom), which is exactly the
+            // "scroll up to the first message and get snapped back to the bottom" bug.
+            if (justOpened || atBottom) {
+                if (isNewLine && !justOpened && !reduce) {
+                    endRef.current?.scrollIntoView({ behavior: "smooth", block: "end" });
+                }
+                else {
+                    el.scrollTop = el.scrollHeight;
+                }
+            }
+            if (justOpened && focusThreadRef.current) {
+                el.focus();
+                focusThreadRef.current = false;
+            }
+            return;
+        }
+        // Streaming growth of the current line: coalesce the bottom-follow into a
+        // single rAF (measure atBottom + write scrollTop at most once per frame).
+        // Same semantics as before — only follows when the reader is at the bottom.
+        if (followRafRef.current != null)
+            return;
+        followRafRef.current = requestAnimationFrame(() => {
+            followRafRef.current = null;
+            const node = threadRef.current;
+            if (!node)
+                return;
+            const atBottom = node.scrollHeight - node.scrollTop - node.clientHeight < 80;
+            if (atBottom)
+                node.scrollTop = node.scrollHeight;
+        });
+    }, [lastId, lastContent, sheetOpen]);
+    // The closed peek must always whisper the NEWEST line, but closing is an
+    // animated height collapse: a one-shot scroll set runs before the height
+    // finishes shrinking, leaving the peek parked mid-thread as clientHeight
+    // drops. Observe the peek while closed and re-pin to the bottom on every size
+    // change (animation frames, web-font reflow, viewport resize) until it
+    // settles. Disconnects the moment the sheet opens.
+    React.useEffect(() => {
+        const el = threadRef.current;
+        if (!el || sheetOpen || typeof ResizeObserver === "undefined")
+            return;
+        const pin = () => {
+            el.scrollTop = el.scrollHeight;
+        };
+        pin();
+        const ro = new ResizeObserver(pin);
+        ro.observe(el);
+        return () => ro.disconnect();
+    }, [sheetOpen]);
+    // Send `text` (and optional images) through the normal chat pipeline, clearing
+    // the composer. Shared by the send button, the slash menu (agent commands),
+    // and suggestion taps.
+    const submitText = React.useCallback((text, images = []) => {
+        const trimmed = text.trim();
+        // An image-only turn is valid; only bail when there's nothing to send.
+        if ((!trimmed && images.length === 0) || !canSend)
+            return;
+        setDraft("");
+        setSlashDismissed(false);
+        setPendingImages([]);
+        setImageError(null);
+        if (images.length) {
+            send(trimmed, { images });
+        }
+        else {
+            send(trimmed);
+        }
+        // Open the thread to show the conversation + the streaming reply, the same
+        // HALF detent focusing/typing uses — NOT a full-screen takeover on every
+        // send (that shoved the messages up too high). Keep a taller detent if the
+        // user already opened one; clear any free-rest so the height matches.
+        setFreeH(null);
+        setMode((m) => (m === "half" || m === "full" ? m : "half"));
+        // Sending COMMITS to the open chat: a deliberate message means this is now
+        // an active conversation, so dismissing the keyboard afterwards keeps the
+        // thread open (preFocusCollapsedRef gates that) instead of collapsing the
+        // whole conversation back to the bare input peek — even when the chat was
+        // opened by tapping the collapsed input.
+        preFocusCollapsedRef.current = false;
+        detentHaptic();
+        inputRef.current?.focus();
+    }, [canSend, send]);
+    // Tapping a suggestion sends it immediately (same path as submit), so the
+    // strip is a one-tap shortcut, not just a draft pre-fill.
+    const pickSuggestion = React.useCallback((text) => {
+        if (!canSend)
+            return;
+        setDraft("");
+        send(text);
+        // Open to HALF (conversation above the keyboard), not a full-screen jump.
+        setFreeH(null);
+        setMode((m) => (m === "half" || m === "full" ? m : "half"));
+        detentHaptic();
+        inputRef.current?.focus();
+    }, [canSend, send]);
+    const addImageFiles = React.useCallback((files) => {
+        void intakeAttachmentFiles(files)
+            .then(({ attachments, droppedTooLarge }) => {
+            // The overlay is a pure component without an i18n translator, so it
+            // surfaces the "kept N, dropped M" notice inline in English (matching
+            // its other hardcoded strings) via the existing imageError channel.
+            const summary = summarizeDroppedAttachments({
+                acceptedCount: attachments.length,
+                droppedTooLarge,
+                droppedOverCount: [],
+            });
+            setImageError(summary
+                ? `Kept ${summary.kept}, dropped ${summary.dropped} (too large — max ${summary.maxMb}MB)`
+                : null);
+            if (attachments.length) {
+                setPendingImages((prev) => [...prev, ...attachments].slice(0, MAX_CHAT_IMAGES));
+            }
+        })
+            .catch((err) => {
+            // Surface the failure inline rather than silently dropping the image —
+            // the overlay is pure, so it can't reach the global notice channel.
+            setImageError(err instanceof Error ? err.message : "Couldn't read image");
+        });
+    }, []);
+    const removeImage = React.useCallback((index) => {
+        setPendingImages((prev) => prev.filter((_, i) => i !== index));
+    }, []);
+    // ── Push-to-talk state machine ──────────────────────────────────────────────
+    // ONE phase ref is the source of truth: idle → (press) pending → (200ms hold)
+    // holding → (release) idle. `pttHolding` mirrors only what the label needs.
+    // A quick tap releases while still "pending" (never started a capture) and
+    // falls through to handleMicClick → toggleHandsFree. A held release stops the
+    // dictation and suppresses the trailing click so it doesn't ALSO toggle.
+    const beginPushToTalkPress = React.useCallback((event) => {
+        // Only arm from idle, primary button, no draft, and no capture already
+        // live (a tap while hands-free toggles it off — handleMicClick). No
+        // `booting` guard: voice capture is independent of agent-respond readiness.
+        if (pttRef.current.kind !== "idle" ||
+            event.button !== 0 ||
+            hasDraft ||
+            recording ||
+            transcriptionMode ||
+            // Voice input is gated while a reply is in flight; type + send to queue
+            // another turn instead. Re-enabled the instant the reply finishes.
+            responding)
+            return;
+        const { pointerId } = event;
+        try {
+            event.currentTarget.setPointerCapture(pointerId);
+        }
+        catch {
+            // Synthetic/detached pointer — capture is best-effort.
+        }
+        const timer = window.setTimeout(() => {
+            // Promote to holding only if still pending for THIS pointer.
+            const phase = pttRef.current;
+            if (phase.kind !== "pending" || phase.pointerId !== pointerId)
+                return;
+            pttRef.current = { kind: "holding", pointerId };
+            setPttHolding(true);
+            // Press-and-hold = dictation: fills the composer draft (no send).
+            startRecording("dictate");
+        }, 200);
+        pttRef.current = { kind: "pending", pointerId, timer };
+    }, [hasDraft, recording, responding, startRecording, transcriptionMode]);
+    // One funnel for BOTH pointerup (cancelled=false) and pointercancel
+    // (cancelled=true). Always clears the pending timer + releases pointer capture
+    // FIRST — before any early return — so a quick tap can never leak a stuck timer
+    // or a captured pointer (the bug that mis-routed later events).
+    const finishPushToTalkPress = React.useCallback((event, cancelled) => {
+        const phase = pttRef.current;
+        if (phase.kind === "pending")
+            window.clearTimeout(phase.timer);
+        if (typeof event.currentTarget.hasPointerCapture === "function" &&
+            event.currentTarget.hasPointerCapture(event.pointerId)) {
+            event.currentTarget.releasePointerCapture(event.pointerId);
+        }
+        pttRef.current = { kind: "idle" };
+        if (phase.kind === "holding") {
+            stopRecording();
+            setPttHolding(false);
+            // A real click follows a pointer-UP (never a cancel); suppress it so the
+            // dictation release doesn't also toggle hands-free. Setting it ONLY here
+            // means it can never leak true into the next legitimate tap.
+            if (!cancelled)
+                suppressNextClickRef.current = true;
+        }
+    }, [stopRecording]);
+    const handleMicClick = React.useCallback(() => {
+        if (suppressNextClickRef.current) {
+            suppressNextClickRef.current = false;
+            return;
+        }
+        // Voice can't be turned ON while a reply is in flight (it's gated until the
+        // turn finishes), but an active hands-free session can always be turned OFF.
+        if (responding && !handsFree)
+            return;
+        // While transcribing, the mic is the master voice control: a tap turns the
+        // mic OFF, which also ends transcription (mic = parent — turning off the mic
+        // turns off transcript). This is distinct from the transcript button, which
+        // turns transcript off but LEAVES THE MIC ON. The finished transcript still
+        // drops into the composer as an attachment.
+        if (transcriptionMode) {
+            stopTranscriptionAndMic();
+            return;
+        }
+        // Quick tap = hands-free conversation: the agent speaks its replies back and
+        // the mic re-opens after each one. Tap again to end.
+        toggleHandsFree();
+    }, [
+        responding,
+        handsFree,
+        toggleHandsFree,
+        transcriptionMode,
+        stopTranscriptionAndMic,
+    ]);
+    const hasThread = visibleMessages.length > 0;
+    // Track the VISUAL viewport so the chat sizes to — and sits above — whatever
+    // the mobile keyboard leaves visible. `height` shrinks when the keyboard opens
+    // (on iOS innerHeight does not, so read visualViewport); `keyboardInset` is how
+    // far the keyboard intrudes from the layout bottom, used to lift the whole
+    // overlay above it. `bottomPad` is the overlay's own safe-area/nav padding,
+    // reserved when bounding the panel height.
+    const readViewport = React.useCallback(() => {
+        if (typeof window === "undefined")
+            return { height: 800, keyboardInset: 0, innerHeight: 800 };
+        const vv = window.visualViewport;
+        const innerHeight = window.innerHeight;
+        const height = vv?.height ?? innerHeight;
+        const keyboardInset = vv
+            ? Math.max(0, innerHeight - vv.height - vv.offsetTop)
+            : 0;
+        // innerHeight is the LAYOUT viewport: on Android it shrinks (adjustResize)
+        // when the keyboard opens, on iOS (`resize: "body"`) it does not. The lift
+        // math below uses that to avoid double-counting the keyboard.
+        return { height, keyboardInset, innerHeight };
+    }, []);
+    const [viewport, setViewport] = React.useState(readViewport);
+    const [bottomPad, setBottomPad] = React.useState(0);
+    React.useEffect(() => {
+        if (typeof window === "undefined")
+            return undefined;
+        const commit = () => {
+            // Bail out of the re-render when the viewport values are unchanged — vv
+            // `scroll` fires constantly while the keyboard animates but the height/
+            // inset frequently don't actually move between events.
+            setViewport((prev) => {
+                const next = readViewport();
+                return prev.height === next.height &&
+                    prev.keyboardInset === next.keyboardInset &&
+                    prev.innerHeight === next.innerHeight
+                    ? prev
+                    : next;
+            });
+            const el = overlayRef.current;
+            if (el) {
+                const pad = Number.parseFloat(getComputedStyle(el).paddingBottom) || 0;
+                setBottomPad((prev) => (prev === pad ? prev : pad));
+            }
+        };
+        // Coalesce the high-rate vv `scroll` to at most one commit per frame so the
+        // keyboard-animation storm can't drive >60 forced style reads + setStates/s.
+        let rafId = 0;
+        const sync = () => {
+            if (rafId !== 0)
+                return;
+            rafId = requestAnimationFrame(() => {
+                rafId = 0;
+                commit();
+            });
+        };
+        // A viewport SIZE change (rotation) must never strand the pill↔input morph
+        // mid-crossfade — rotation often cancels the in-flight pointer with no
+        // pointerup, leaving the drag orphaned (openProgress frozen mid-range = BOTH
+        // the grabber bar and the pill bar visible). Re-settle to a clean 0/1 end so
+        // the crossfade always resolves to exactly one bar. (No-op at rest; a live
+        // legit drag rotating is rare and settling is the right call there too.)
+        // Plain `sync` (no settle) stays on vv `scroll` — that fires constantly while
+        // the keyboard animates and must not interrupt an open sheet.
+        const syncAndSettle = () => {
+            sync();
+            settleDragRef.current?.();
+        };
+        syncAndSettle();
+        const vv = window.visualViewport;
+        window.addEventListener("resize", syncAndSettle);
+        vv?.addEventListener("resize", syncAndSettle);
+        vv?.addEventListener("scroll", sync, { passive: true });
+        return () => {
+            if (rafId !== 0)
+                cancelAnimationFrame(rafId);
+            window.removeEventListener("resize", syncAndSettle);
+            vv?.removeEventListener("resize", syncAndSettle);
+            vv?.removeEventListener("scroll", sync);
+        };
+    }, [readViewport]);
+    const viewportH = viewport.height;
+    const keyboardInset = viewport.keyboardInset;
+    // iOS keyboard avoidance. With Capacitor `resize:"body"`, the software
+    // keyboard shrinks the BODY but NOT the visual viewport's relationship to a
+    // `position: fixed` element, and the visualViewport delta above frequently
+    // reads 0 — so `keyboardInset` alone can't lift the fixed composer and it
+    // ends up hidden BEHIND the keyboard (reported on device + simulator).
+    // Subscribe to the Capacitor Keyboard plugin for the authoritative keyboard
+    // height and lift by whichever inset is larger.
+    const [nativeKeyboardHeight, setNativeKeyboardHeight] = React.useState(0);
+    React.useEffect(() => {
+        if (typeof window === "undefined")
+            return undefined;
+        let cancelled = false;
+        const handles = [];
+        void import("@capacitor/keyboard")
+            .then(({ Keyboard }) => {
+            if (cancelled)
+                return;
+            void Keyboard.addListener("keyboardWillShow", (info) => {
+                setNativeKeyboardHeight(info?.keyboardHeight ?? 0);
+            })
+                .then((handle) => {
+                if (cancelled)
+                    handle.remove();
+                else
+                    handles.push(handle);
+            })
+                .catch(() => { });
+            void Keyboard.addListener("keyboardWillHide", () => {
+                setNativeKeyboardHeight(0);
+            })
+                .then((handle) => {
+                if (cancelled)
+                    handle.remove();
+                else
+                    handles.push(handle);
+            })
+                .catch(() => { });
+        })
+            .catch(() => {
+            // Web / non-native: no Keyboard plugin; visualViewport handles it.
+        });
+        return () => {
+            cancelled = true;
+            for (const handle of handles)
+                handle.remove();
+        };
+    }, []);
+    // Track the layout-viewport height with the keyboard DOWN. On Android the
+    // WebView window shrinks (adjustResize) when the keyboard opens, so the fixed
+    // overlay's `bottom: 0` already rises with it; on iOS (`resize: "body"`) the
+    // layout height is unchanged and the fixed composer stays behind the keyboard.
+    const baseInnerHeightRef = React.useRef(viewport.innerHeight);
+    React.useEffect(() => {
+        if (nativeKeyboardHeight === 0) {
+            baseInnerHeightRef.current = viewport.innerHeight;
+        }
+    }, [nativeKeyboardHeight, viewport.innerHeight]);
+    // Lift the composer above the keyboard by ONLY the part the layout didn't
+    // already absorb. On Android the window shrank by ~the keyboard height
+    // (layoutShrink ≈ keyboardHeight), so the extra native lift is ~0 — without
+    // this the chat double-counts and jumps a whole keyboard height too high. On
+    // iOS the layout doesn't shrink (layoutShrink = 0), so the full native height
+    // lifts the fixed composer above the keyboard. Web (no native plugin) keeps
+    // the visualViewport-derived inset.
+    const layoutShrink = Math.max(0, baseInnerHeightRef.current - viewport.innerHeight);
+    const nativeLift = Math.max(0, nativeKeyboardHeight - layoutShrink);
+    const effectiveKeyboardInset = Math.max(keyboardInset, nativeLift);
+    // FULL-SCREEN derived gate: maximized only takes effect AT the full detent, so
+    // a stale flag can never leak into half/collapsed/pill. Drives the edge-to-edge
+    // panel styles + a zero top margin.
+    const fullBleed = maximized && expanded && sheetOpen && !pilled;
+    // The chat panel may never exceed the visible height minus its own
+    // safe-area/nav padding and a top margin — so it can't spill above the screen.
+    // The thread (flex-shrink) gives way to this cap, scrolling instead of pushing
+    // the panel off-screen. Maximized drops the top margin so it reaches the top.
+    const topMargin = fullBleed ? 0 : SHEET_TOP_MARGIN;
+    // Full-bleed drops the overlay's own bottom padding (its `paddingBottom` is 0
+    // edge-to-edge — the composer carries the home-gesture clearance itself), so
+    // the panel must fill the ENTIRE viewport height. Subtracting the (bottom-anchored)
+    // `bottomPad` here would shrink the panel by the gesture inset and float it a
+    // gesture-inset BELOW the top — the gap that left a hard-cut glass seam under
+    // the status bar and pushed the safe-area-padded header buttons down.
+    const panelMaxH = Math.max(200, viewportH - (fullBleed ? 0 : bottomPad) - topMargin);
+    // History-height detents: COLLAPSED (0) → HALF → FULL — the thread's ideal
+    // flex-basis; flex-shrink clamps the real height to fit. FULL == panelMaxH so
+    // the detent target matches the visible height (no dead slack at the top of a
+    // pull-down) while the sheet rises all the way to the top.
+    const openH = panelMaxH;
+    const halfH = Math.round(viewportH * SHEET_HALF_VH);
+    const detentH = !sheetOpen ? 0 : expanded ? openH : halfH;
+    // A free-drag rest height wins over the detent until a detent is re-taken.
+    const baseH = freeH != null ? Math.min(freeH, panelMaxH) : detentH;
+    // The single explicit state of the chat surface — the named machine the rest
+    // of the component (header gate, data attribute, transitions) reads from. It
+    // is DERIVED from the resting height so it always agrees with what's on
+    // screen; the live drag stays on the `threadHeight` motion value (no
+    // re-render per frame). The five states:
+    //   CLOSED            — pill only (sheet pilled away)
+    //   INPUT             — composer bar, no thread (the resting closed state)
+    //   OPEN_UNDER_HALF   — opened but below the half detent (a deliberate slow
+    //                       pull rested here); header buttons stay hidden
+    //   OPEN_HALF_OR_OVER — at the half detent or taller (header buttons show)
+    //   MAXIMIZED         — full-bleed edge-to-edge
+    // Transitions: pill tap / flick-up → INPUT; focus·type·flick·send → an OPEN_*
+    // state; pull-down → INPUT → CLOSED; maximize toggle ↔ MAXIMIZED; Home/Settings
+    // animate out of MAXIMIZED then collapse (see navigateAndClose).
+    // MAXIMIZED is keyed off the SAME `fullBleed` predicate the styles use, so the
+    // enum and the full-bleed layout can never disagree (no "maximized at half"
+    // ghost state).
+    const chatState = pilled
+        ? "CLOSED"
+        : !sheetOpen
+            ? "INPUT"
+            : fullBleed
+                ? "MAXIMIZED"
+                : baseH >= halfH - 1
+                    ? "OPEN_HALF_OR_OVER"
+                    : "OPEN_UNDER_HALF";
+    // Header buttons (maximize/clear/home/settings) are gated on the LIVE rendered
+    // height, NOT the settled enum — otherwise dragging the panel below half keeps
+    // the header mounted on a too-short panel (the "buttons between input and half"
+    // bug). They show only when the panel actually renders at/over half (or is
+    // full-bleed), tracking the finger frame-by-frame; the prev===next guard keeps
+    // re-renders to the two threshold crossings.
+    const evalHeaderVisible = React.useCallback((h) => !pilled && (fullBleed || h >= halfH - 1), [pilled, fullBleed, halfH]);
+    const [headerVisible, setHeaderVisible] = React.useState(false);
+    useMotionValueEvent(threadHeight, "change", (h) => {
+        const next = evalHeaderVisible(h);
+        setHeaderVisible((prev) => (prev === next ? prev : next));
+    });
+    // Re-evaluate on settled-state changes that don't tick the height (programmatic
+    // pill/maximize/open with the spring already at rest).
+    // biome-ignore lint/correctness/useExhaustiveDependencies: threadHeight is a stable motion ref
+    React.useEffect(() => {
+        setHeaderVisible(evalHeaderVisible(threadHeight.get()));
+    }, [evalHeaderVisible]);
+    // Map a raw drag height: rubber-band past FULL, hard-clamp the bottom to 0.
+    const clampHeight = React.useCallback((raw) => raw > openH ? openH + rubberBand(raw - openH) : Math.max(0, raw), [openH]);
+    // Backdrop dimming + the suggestion-strip fade follow the live height; the
+    // thread's flex-basis is the live height as a px string.
+    const revealed = useTransform(threadHeight, (h) => Math.min(1, Math.max(0, h / Math.max(1, openH))));
+    // At rest (threadHeight 0 = INPUT/CLOSED) the full-viewport dimming scrim sits
+    // at opacity 0. Drive `visibility` off the SAME motion value so it drops out
+    // of compositing/paint at rest (no reflow, compositor-only, zero re-render) and
+    // flips back the instant the thread opens.
+    const scrimVisibility = useTransform(threadHeight, (h) => h > 0 ? "visible" : "hidden");
+    const suggestionsOpacity = useTransform(threadHeight, (h) => Math.max(0, 1 - h / Math.max(1, openH * 0.5)));
+    const threadFlexBasis = useTransform(threadHeight, (h) => `${h}px`);
+    // Corner radius tracks the live height so it can't flash as a tall full-pill
+    // mid-pull: a perfect pill at rest (collapsed input, matching the round
+    // buttons) relaxing to a calm 24px the instant the thread starts opening.
+    const panelRadius = useTransform(threadHeight, [0, 12], [9999, 24], {
+        clamp: true,
+    });
+    // --- Liquid-glass pill → input morph (driven by openProgress) ---------------
+    // The panel is ONE persistent element; the pill capsule and the full
+    // input crossfade by opacity (compositor-cheap) while the whole panel scales
+    // up from a capsule. transform + opacity only.
+    const panelScale = useTransform(openProgress, [0, 1], [0.9, 1]);
+    // Glass surface + its content crossfade IN as the input forms (one wrapper, so
+    // sheen/glow/thread/composer resolve together with the glass).
+    const glassOpacity = useTransform(openProgress, [0, 1], [0, 1]);
+    // The pill capsule fades OUT over the first half of the open so it has cleared
+    // before the input controls resolve (no double-image mid-morph).
+    const pillOpacity = useTransform(openProgress, [0, 0.55], [1, 0], {
+        clamp: true,
+    });
+    // The drag-handle (SheetGrabber) bar is IDENTICAL to the pill bar, so they must
+    // never both be on screen. The pill fades OUT over [0, 0.55]; the grabber fades
+    // IN only over [0.55, 0.95] — a strict crossfade with no overlap. (Before, the
+    // grabber mounted at full opacity the instant `pilled` flipped false, while the
+    // pill was still fading out → two bars = the "two pills" bug.)
+    const grabberOpacity = useTransform(openProgress, [0.55, 0.95], [0, 1], {
+        clamp: true,
+    });
+    // Header reveal tracks the LIVE height: as the panel approaches the half
+    // detent the top buttons FADE in and their space LERPS open; pulling back
+    // below half fades them out and collapses the space — no pop. (Maximized sits
+    // at openH ≫ half, so it's fully revealed.) overflow-hidden on the header clips
+    // the buttons while the space is still opening.
+    const headerOpacity = useTransform(threadHeight, [halfH - 64, halfH], [0, 1], {
+        clamp: true,
+    });
+    const headerMaxH = useTransform(threadHeight, [halfH - 64, halfH], [0, 100], {
+        clamp: true,
+    });
+    // The header's top padding LERPS with the same live height. A flex item's
+    // `min-height:auto` lets its padding survive `max-height:0`, so a static
+    // `pt-2.5` would leak ~10px above the composer in the collapsed/input state
+    // (extra, irregular top margin). Driving padding-top 0 → 10px alongside the
+    // reveal keeps the collapsed panel exactly the input-bar height, then opens
+    // the breathing room as the header fades in.
+    const headerPadTop = useTransform(threadHeight, [halfH - 64, halfH], [0, 10], {
+        clamp: true,
+    });
+    // Grabber clearance: when the chat is OPEN but BELOW the half detent the header
+    // is hidden, so the thread viewport would start at the panel's very top —
+    // tucking the topmost line under the floating drag handle (a partial bubble
+    // pinned beneath the grabber at a small free-rest height). Inset the thread
+    // down by the grabber's height in that window only: 0 at the collapsed peek
+    // (threadHeight ~0, so the closed input bar stays exactly its own height),
+    // ramping to the inset once a thread is actually open, then back to 0 as the
+    // header reveals at half+ (it provides the clearance itself).
+    const threadGrabberClearance = useTransform(threadHeight, [0, 40, halfH - 64, halfH], [0, 20, 20, 0], { clamp: true });
+    // Sub-threshold release: spring back to the current detent (no state change).
+    // Also settles the pill→input morph to its resting end (0 while pilled, 1 once
+    // open) so a half-finished pill drag springs cleanly back to the capsule.
+    const settleDrag = React.useCallback(() => {
+        draggingRef.current = false;
+        const open = pilled ? 0 : 1;
+        if (reduce) {
+            stopThreadAnimation();
+            stopOpenProgressAnimation();
+            threadHeight.set(baseH);
+            openProgress.set(open);
+        }
+        else {
+            animateThreadHeight(baseH);
+            animateOpenProgress(open);
+        }
+    }, [
+        threadHeight,
+        openProgress,
+        baseH,
+        pilled,
+        reduce,
+        stopThreadAnimation,
+        stopOpenProgressAnimation,
+        animateThreadHeight,
+        animateOpenProgress,
+    ]);
+    // Keep the ref the (earlier-declared) viewport-resize effect calls pointing at
+    // the latest settleDrag, so a rotation re-settles with current pilled/baseH.
+    settleDragRef.current = settleDrag;
+    // Drive openProgress from the pilled flag for NON-drag transitions (tap the
+    // pill, programmatic open/close): a live finger drag owns openProgress itself
+    // (draggingRef gates this so it never fights the gesture).
+    React.useEffect(() => {
+        if (draggingRef.current)
+            return;
+        const open = pilled ? 0 : 1;
+        if (reduce) {
+            stopOpenProgressAnimation();
+            openProgress.set(open);
+            return;
+        }
+        animateOpenProgress(open);
+        return stopOpenProgressAnimation;
+    }, [
+        pilled,
+        reduce,
+        openProgress,
+        animateOpenProgress,
+        stopOpenProgressAnimation,
+    ]);
+    const closeSheet = React.useCallback(() => {
+        draggingRef.current = false;
+        stopThreadAnimation();
+        stopOpenProgressAnimation();
+        setFreeH(null);
+        setMaximized(false);
+        setMode("input");
+    }, [stopThreadAnimation, stopOpenProgressAnimation]);
+    // Leaving the chat for Settings/Home: animate OUT of maximize and collapse the
+    // sheet (closeSheet un-maximizes + springs the thread height down) BEFORE
+    // swapping the page underneath, so it reads as the chat closing into the new
+    // view rather than a jump-cut from full-screen. The page swap waits a beat for
+    // the collapse spring to start (a touch longer when leaving MAXIMIZED, since
+    // there's more to unwind); reduced motion navigates immediately.
+    const navigateAndClose = React.useCallback((go) => {
+        const wasMaximized = maximized;
+        closeSheet();
+        if (delayedNavigationTimerRef.current !== null) {
+            window.clearTimeout(delayedNavigationTimerRef.current);
+        }
+        delayedNavigationTimerRef.current = window.setTimeout(() => {
+            delayedNavigationTimerRef.current = null;
+            go();
+        }, reduce ? 0 : wasMaximized ? 260 : 190);
+    }, [closeSheet, maximized, reduce]);
+    // Maximize toggle. Maximizing from ANY open detent (half or a free rest) first
+    // rises to the FULL detent, then drops the inset — so the height spring
+    // animates up and the panel goes edge-to-edge in one gesture (previously
+    // full-bleed required `expanded`, so tapping maximize at the half detent did
+    // nothing). Un-maximizing drops back to the inset FULL detent.
+    const toggleMaximize = React.useCallback(() => {
+        if (maximized) {
+            stopThreadAnimation();
+            setMaximized(false);
+            return;
+        }
+        // Snap the morph fully open BEFORE flipping to full-bleed so no in-flight
+        // pill-open spring can leak a sub-1 scale into the maximized frame (top gap).
+        draggingRef.current = false;
+        stopThreadAnimation();
+        stopOpenProgressAnimation();
+        openProgress.set(1);
+        setFreeH(null);
+        setMode("full");
+        setMaximized(true);
+    }, [maximized, openProgress, stopThreadAnimation, stopOpenProgressAnimation]);
+    // The single detent→detent animator: whenever the settled detent (or viewport)
+    // changes and we're not mid finger-drag, spring the history height to it. The
+    // gesture / open paths just flip sheetOpen/expanded and this reacts — no
+    // per-frame React state, so the live drag stays buttery.
+    React.useEffect(() => {
+        if (draggingRef.current)
+            return;
+        if (reduce) {
+            stopThreadAnimation();
+            threadHeight.set(baseH);
+            return;
+        }
+        animateThreadHeight(baseH);
+        return stopThreadAnimation;
+    }, [baseH, reduce, threadHeight, animateThreadHeight, stopThreadAnimation]);
+    // Snap to one of the three iOS-style detents and settle the live drag. A
+    // detent change fires a light haptic so the snap feels physical on device.
+    // "collapsed" hides the history entirely (just the input); "half" is the
+    // comfortable reading height; "full" the near-fullscreen reading mode.
+    const goToDetent = React.useCallback((to) => {
+        // Flip the settled detent; the [baseH] effect springs the height to it.
+        // A detent always clears any free-drag rest height and (since only FULL
+        // can be maximized) drops full-bleed when stepping anywhere else.
+        draggingRef.current = false;
+        stopThreadAnimation();
+        setFreeH(null);
+        if (to !== "full")
+            setMaximized(false);
+        // "collapsed" is the input peek (sheet closed); half/full open the thread.
+        setMode(to === "collapsed" ? "input" : to);
+        // Stepping all the way down closes the keyboard (the chat is dismissed).
+        if (to === "collapsed")
+            inputRef.current?.blur();
+        detentHaptic();
+    }, [stopThreadAnimation]);
+    // Collapsing always drops input focus, so the mobile keyboard goes away the
+    // moment the chat is dismissed (pull-down, Escape, or click-out) — the chat is
+    // no longer "focused". Blurring (rather than the old refocus dance) also means
+    // there's no focus→expand bounce to guard against, so the model stays simple.
+    const collapse = React.useCallback(() => {
+        // If focus is sitting inside the thread log, pull it out before the log
+        // becomes aria-hidden / tabIndex=-1 — never park focus on a hidden element.
+        if (typeof document !== "undefined" &&
+            threadRef.current &&
+            document.activeElement instanceof HTMLElement &&
+            threadRef.current.contains(document.activeElement)) {
+            document.activeElement.blur();
+        }
+        closeSheet();
+        inputRef.current?.blur();
+    }, [closeSheet]);
+    // Dismiss the keyboard and return to the resting state from BEFORE the composer
+    // was focused — the single restore path shared by every "drop the keyboard"
+    // gesture (tap the grabber, tap the scrim, tap outside the panel). A sheet that
+    // was COLLAPSED before focus re-collapses (back to the input bar); one that was
+    // ALREADY OPEN stays open and springs back to its detent size as the keyboard
+    // retracts (the viewport grows → the [baseH] effect re-animates the height).
+    // Never a surprise full close.
+    const dismissKeyboardToPriorState = React.useCallback(() => {
+        inputRef.current?.blur();
+        if (preFocusCollapsedRef.current)
+            collapse();
+    }, [collapse]);
+    // The composer overlay floats over every view and survives tab changes, so
+    // navigating away from a focused composer (chat → Settings / Home / …) would
+    // otherwise leave the textarea holding DOM focus on the new view (its
+    // collapsed/resting look is gated on sheet state, not on document focus). On
+    // iOS that strands the keyboard input-accessory bar (the ‹ › chevrons +
+    // "Done") at the bottom of the screen with no keyboard while the composer
+    // reads as inactive. Drop composer focus whenever the active view changes to a
+    // non-chat tab; an intentional tap to focus the composer on that view (no tab
+    // change) is left untouched. Keyboard.hide() guarantees iOS dismisses the
+    // accessory bar, not just the soft keyboard.
+    React.useEffect(() => {
+        if (currentTab === "chat")
+            return;
+        const input = inputRef.current;
+        if (typeof document === "undefined" ||
+            !input ||
+            document.activeElement !== input) {
+            return;
+        }
+        input.blur();
+        void import("@capacitor/keyboard")
+            .then(({ Keyboard }) => Keyboard.hide())
+            .catch(() => {
+            // Web/desktop or no native bridge — blur() above already dropped focus.
+        });
+    }, [currentTab]);
+    // Focusing or typing in the composer opens the chat (keyboard + history) when
+    // there's a thread to show. Opens to HALF — the conversation is visible above
+    // the keyboard without a full-screen takeover; the maximize button is for that.
+    // Remember whether we opened from collapsed so dismissing the keyboard (tap the
+    // handle) can return to that prior resting state. Clears any free-rest so the
+    // height matches the detent (no stale freeH pinning it below half).
+    const expand = React.useCallback(() => {
+        if (!hasThread)
+            return;
+        preFocusCollapsedRef.current = !sheetOpen;
+        setFreeH(null);
+        // Open to at least HALF; if already at half/full, keep the taller mode.
+        setMode((m) => (m === "half" || m === "full" ? m : "half"));
+    }, [hasThread, sheetOpen]);
+    // Interactive tour control: the tutorial drives the chat into a clean, known
+    // state at the start of each frame (so the spotlight always lands on the right
+    // control) and pre-fills the composer for the guided "ask to navigate" demo.
+    // Decoupled via a window event so the tour never reaches into these internals.
+    React.useEffect(() => {
+        if (typeof window === "undefined")
+            return undefined;
+        const onControl = (event) => {
+            const detail = event.detail;
+            if (!detail)
+                return;
+            switch (detail.action) {
+                case "pill":
+                    setMode("pill");
+                    inputRef.current?.blur();
+                    break;
+                case "rest":
+                    // goToDetent("collapsed") → input mode, which un-pills.
+                    goToDetent("collapsed");
+                    break;
+                case "expand":
+                    goToDetent("full");
+                    break;
+                case "prefill":
+                    setMode((m) => (m === "pill" ? "input" : m));
+                    setDraft(detail.text ?? "");
+                    requestAnimationFrame(() => inputRef.current?.focus());
+                    break;
+                case "reset":
+                    // Tour ended (cancel / complete): restore a normal interactive chat.
+                    // A frame may have collapsed it to the pill, where the composer is
+                    // `inert` — clear inert imperatively (React clears it only on the next
+                    // render, too late for the stranded input), drop the tour's prefilled
+                    // draft, and goToDetent("collapsed") un-pills back to the input bar.
+                    contentRef.current?.removeAttribute("inert");
+                    setDraft("");
+                    goToDetent("collapsed");
+                    break;
+            }
+        };
+        window.addEventListener(TUTORIAL_CHAT_CONTROL_EVENT, onControl);
+        return () => window.removeEventListener(TUTORIAL_CHAT_CONTROL_EVENT, onControl);
+    }, [goToDetent]);
+    React.useEffect(() => {
+        if (typeof window === "undefined")
+            return undefined;
+        const onPrefill = (event) => {
+            const detail = event.detail;
+            const text = typeof detail?.text === "string" ? detail.text : "";
+            if (!text.trim())
+                return;
+            setMode((m) => (m === "pill" ? "input" : m));
+            setDraft(text);
+            const focusComposer = () => {
+                prefillFocusFrameRef.current = null;
+                prefillFocusTimerRef.current = null;
+                const input = inputRef.current;
+                input?.focus();
+                if (detail?.select) {
+                    input?.setSelectionRange(0, text.length);
+                }
+            };
+            clearPrefillFocusSchedule();
+            if (typeof window.requestAnimationFrame === "function") {
+                prefillFocusFrameRef.current =
+                    window.requestAnimationFrame(focusComposer);
+            }
+            else {
+                prefillFocusTimerRef.current = window.setTimeout(focusComposer, 0);
+            }
+        };
+        window.addEventListener(CHAT_PREFILL_EVENT, onPrefill);
+        return () => window.removeEventListener(CHAT_PREFILL_EVENT, onPrefill);
+    }, [clearPrefillFocusSchedule]);
+    // Push-to-talk dictation drops its final transcript into the composer draft
+    // (no send): register the sink with the controller while this overlay is
+    // mounted, appending to whatever the user has already typed.
+    React.useEffect(() => {
+        setDictationSink((text) => {
+            setDraft((current) => (current ? `${current} ${text}` : text));
+            inputRef.current?.focus();
+            expand();
+        });
+        return () => setDictationSink(null);
+    }, [setDictationSink, expand]);
+    // A completed transcription SESSION drops its transcript into the composer as
+    // an ATTACHMENT — it does NOT auto-send as a message. The user sends it (with
+    // any typed text) when ready; the mic stays on the whole time, so transcribing
+    // is an additive layer, not a mode that takes over the conversation. The
+    // recording is also archived (Transcript record + audio + knowledge mirror)
+    // for the Transcripts view, best-effort and silent.
+    React.useEffect(() => {
+        setTranscriptSessionSink((segments, startedAtMs, audioWav) => {
+            if (segments.length === 0)
+                return;
+            const text = transcriptPlainText(segments);
+            const stamp = new Date(startedAtMs)
+                .toISOString()
+                .slice(0, 16)
+                .replace("T", " ");
+            const attachmentName = `Transcript ${stamp}.md`;
+            if (text) {
+                const attachment = {
+                    data: textToBase64(text),
+                    mimeType: "text/markdown",
+                    name: attachmentName,
+                };
+                setPendingImages((prev) => [...prev, attachment].slice(0, MAX_CHAT_IMAGES));
+                expand();
+                inputRef.current?.focus();
+            }
+            void client
+                .createTranscript({
+                segments,
+                createdAt: startedAtMs,
+                ...(audioWav
+                    ? {
+                        audioBase64: wavBytesToBase64(audioWav),
+                        audioContentType: "audio/wav",
+                    }
+                    : {}),
+            })
+                .then(({ transcript }) => {
+                // Link the pending attachment to the saved record so tapping it opens
+                // the editable viewer and edits persist — both via the client-only
+                // `transcriptId` field and a durable marker embedded in the markdown
+                // (which survives the server round-trip in the attachment's text).
+                if (!text)
+                    return;
+                setPendingImages((prev) => prev.map((a) => a.name === attachmentName &&
+                    a.mimeType === "text/markdown" &&
+                    !a.transcriptId
+                    ? {
+                        ...a,
+                        transcriptId: transcript.id,
+                        data: textToBase64(withTranscriptMarker(transcript.id, text)),
+                    }
+                    : a));
+            })
+                .catch(() => {
+                /* archival is best-effort; a failed save just skips the record */
+            });
+        });
+        return () => setTranscriptSessionSink(null);
+    }, [setTranscriptSessionSink, expand]);
+    // Tell the controller whether a draft is pending so the hands-free always-on
+    // loop pauses while the user is typing (or editing a PTT dictation) and
+    // resumes the prior voice state once the draft clears on send.
+    React.useEffect(() => {
+        setComposerHasDraft(hasDraft);
+    }, [hasDraft, setComposerHasDraft]);
+    // ── Slash commands ─────────────────────────────────────────────────────────
+    // Inline command autocomplete: the menu derives from the draft + the loaded
+    // catalog; Escape dismisses it (without clearing the draft); typing reopens.
+    const slashMenu = useSlashMenu(draft, slash);
+    // Short-circuit the slash parse on the common (non-slash) keystroke path — a
+    // draft that doesn't start with "/" is never a slash command, so skip the work.
+    const isSlashDraft = draft.startsWith("/") && parseSlashDraft(draft).isSlash;
+    const slashOpen = slashMenu.open && !slashDismissed;
+    // Combobox a11y for the composer input — only when a slash catalog is wired
+    // in. Spread so the input is a plain message box (no role) otherwise.
+    const comboboxAria = slashProp
+        ? {
+            role: "combobox",
+            "aria-autocomplete": "list",
+            "aria-expanded": slashOpen,
+            "aria-controls": slashOpen ? "slash-command-listbox" : undefined,
+            "aria-activedescendant": slashOpen && slashMenu.items[slashMenu.activeIndex]
+                ? `slash-option-${slashMenu.items[slashMenu.activeIndex].id}`
+                : undefined,
+        }
+        : {};
+    // biome-ignore lint/correctness/useExhaustiveDependencies: draft IS the trigger — any edit re-arms the menu after an Escape dismissal.
+    React.useEffect(() => {
+        setSlashDismissed(false);
+    }, [draft]);
+    // Run a resolved slash execution: agent commands flow through the normal send
+    // pipeline; navigation/client commands run their app- or overlay-level effect
+    // and clear the composer.
+    const runExecution = React.useCallback((exec) => {
+        if (exec.kind === "send") {
+            submitText(exec.text);
+            return;
+        }
+        runSlashExecution(exec, {
+            navigateTab: slash.navigateTab,
+            navigateSettings: slash.navigateSettings,
+            navigateView: slash.navigateView,
+            clearChat: slash.clearChat,
+            newConversation: () => controller.clearConversation(),
+            // The overlay owns full-screen via the `maximized` detent flag, not a
+            // controller method, so toggle it directly here.
+            toggleFullscreen: toggleMaximize,
+            openCommandPalette: slash.openCommandPalette,
+            showCommands: slash.openCommandPalette,
+            toggleTranscription: toggleTranscriptionMode,
+            send: (text) => submitText(text),
+        });
+        setDraft("");
+        setSlashDismissed(true);
+        inputRef.current?.focus();
+    }, [slash, controller, submitText, toggleMaximize, toggleTranscriptionMode]);
+    const submit = React.useCallback(() => {
+        const shortcut = pendingImages.length === 0
+            ? resolveClientShortcutExecution(slash.commands, draft, slash.resolveSection, {
+                allowNatural: slash.naturalShortcutsEnabled,
+                resolveChoices: slash.resolveChoices,
+            })
+            : null;
+        if (shortcut) {
+            runExecution(shortcut);
+            return;
+        }
+        submitText(draft, pendingImages);
+    }, [draft, pendingImages, runExecution, slash, submitText]);
+    const pickSlashItem = React.useCallback((index) => {
+        const exec = slashMenu.resolve(index);
+        if (exec)
+            runExecution(exec);
+    }, [slashMenu, runExecution]);
+    // Tapping ANYWHERE outside the chat panel drops the keyboard: if the composer
+    // holds focus and the pointer lands outside the panel, blur it. This is the
+    // iOS-standard "tap the background to dismiss the keyboard" behaviour and works
+    // whether the chat is open (over the scrim) or collapsed (over the live view).
+    React.useEffect(() => {
+        if (typeof document === "undefined")
+            return undefined;
+        const onPointerDown = (event) => {
+            const input = inputRef.current;
+            const focused = !!input && document.activeElement === input;
+            // Record the keyboard state at PRESS time: the scrim's click handler reads
+            // this (focus may be gone by the time the click fires) to tell a first
+            // "dismiss the keyboard" tap from a second "close the chat" tap.
+            composerFocusedAtPressRef.current = focused;
+            // Keyboard already down → outside taps do nothing here (the chat only
+            // closes via a pull-down, the scrim, or Escape).
+            if (!focused)
+                return;
+            const target = event.target;
+            if (target && panelRef.current?.contains(target))
+                return;
+            // Leave a tap on the GRABBER to onTap, which both drops the keyboard AND
+            // returns to the pre-focus resting state — blurring here would preempt it.
+            if (target instanceof Element &&
+                target.closest('[data-testid="chat-sheet-grabber"]')) {
+                return;
+            }
+            // Any other outside tap (incl. the dimming scrim) drops the keyboard and
+            // returns to the pre-focus resting state — never a surprise full close.
+            dismissKeyboardToPriorState();
+        };
+        document.addEventListener("pointerdown", onPointerDown, true);
+        return () => document.removeEventListener("pointerdown", onPointerDown, true);
+    }, [dismissKeyboardToPriorState]);
+    // Escape collapses the chat from ANY open state, even a free-drag open with no
+    // focused element (the element-level handlers on the textarea/thread only fire
+    // when one of them holds focus). Registered only while open.
+    React.useEffect(() => {
+        if (typeof document === "undefined" || !sheetOpen)
+            return undefined;
+        const onKey = (e) => {
+            if (e.key === "Escape") {
+                e.preventDefault();
+                collapse();
+            }
+        };
+        document.addEventListener("keydown", onKey);
+        return () => document.removeEventListener("keydown", onKey);
+    }, [sheetOpen, collapse]);
+    // Auto-grow the composer with multi-line input: snap to the content height
+    // (capped by `max-h` in CSS, which then scrolls). Runs on every draft change
+    // so it also springs back to one line after a send clears the draft.
+    // biome-ignore lint/correctness/useExhaustiveDependencies: draft is the trigger; the body reads the textarea ref
+    React.useLayoutEffect(() => {
+        const el = inputRef.current;
+        if (!el)
+            return;
+        el.style.height = "auto";
+        el.style.height = `${el.scrollHeight}px`;
+    }, [draft]);
+    // Open the input back out of the collapsed pill (tap or keyboard-activate).
+    // A tap routes through the gesture's `onDrag(0)` first, which sets
+    // draggingRef=true AND openProgress=0 — so we MUST clear draggingRef here, or
+    // the pilled→openProgress effect early-returns and the morph stays stuck at 0
+    // (a visible-but-inert pill, no input: the "bad state"). We also spring
+    // openProgress → 1 directly so the open never depends on that effect's timing.
+    const openFromPill = React.useCallback(() => {
+        draggingRef.current = false;
+        // A pill tap OPENS the chat. With a conversation to show, go straight to the
+        // HALF detent — a tap reveals the thread exactly like a flick-up, so a SINGLE
+        // tap always opens the chat (never the old "tap lands on a bare input bar,
+        // tap again to actually open" two-step). Mark it deliberately open so
+        // dismissing the keyboard then KEEPS it at half (preFocusCollapsedRef gates
+        // that). With no thread yet, there's nothing to open into — just form the
+        // bare input bar, and treat a later keyboard dismiss as a re-collapse.
+        if (hasThread) {
+            goToDetent("half");
+            preFocusCollapsedRef.current = false;
+        }
+        else {
+            setMode("input");
+            preFocusCollapsedRef.current = true;
+            detentHaptic();
+        }
+        if (reduce) {
+            stopOpenProgressAnimation();
+            openProgress.set(1);
+        }
+        else
+            animateOpenProgress(1);
+        // Raise the keyboard on the SAME tap that opens the pill. While pilled, the
+        // composer content is `inert`, and React only clears that on the next
+        // render — too late for iOS WebKit, which honors focus() only synchronously
+        // inside the originating user gesture AND only on a non-inert element. So
+        // clear inert imperatively now and focus immediately; otherwise the first
+        // tap opens a composer that silently refuses keyboard input until a second
+        // tap (the reported "chat input doesn't accept text on iOS" bug). Suppress
+        // the focus→expand: the target detent is already set above, and letting
+        // expand run would clobber preFocusCollapsedRef with the (pre-render, still
+        // pilled) sheet state and treat this deliberate open as a re-collapse.
+        contentRef.current?.removeAttribute("inert");
+        suppressExpandOnFocusRef.current = true;
+        inputRef.current?.focus();
+    }, [
+        openProgress,
+        reduce,
+        hasThread,
+        goToDetent,
+        stopOpenProgressAnimation,
+        animateOpenProgress,
+    ]);
+    // --- Pull gesture --------------------------------------------------------
+    // The grabber is the draggable handle. A live drag sets the threadHeight motion
+    // value DIRECTLY (no React state → no re-render per frame, so it tracks the
+    // finger 1:1); release fires onPullUp/onPullDown (distance OR velocity, via
+    // usePullGesture) to snap to a detent.
+    const onDragOffset = React.useCallback((offset) => {
+        if (!draggingRef.current) {
+            stopThreadAnimation();
+            stopOpenProgressAnimation();
+        }
+        draggingRef.current = true;
+        // PILL drag: map the upward travel to the pill→input morph (openProgress).
+        // The thread stays at 0 until the input is fully formed; only the EXCESS
+        // past PILL_OPEN_DISTANCE flows into the thread height, so a single
+        // continuous pull reads pill → input → chat (and a flick-up no longer
+        // flashes a chat sliver, since the thread only grows after the morph).
+        if (pilled) {
+            const up = Math.max(0, offset);
+            openProgress.set(Math.min(1, up / PILL_OPEN_DISTANCE));
+            const excess = up - PILL_OPEN_DISTANCE;
+            threadHeight.set(excess > 0 ? clampHeight(excess) : 0);
+            return;
+        }
+        // INPUT → PILL drag (collapsed, dragging DOWN): the mirror of the pill
+        // drag — map the downward travel to the input→pill morph (openProgress
+        // 1 → 0) so the input bar visibly scales down into the pill capsule under
+        // the finger, instead of staying fully formed and snapping to the pill only
+        // on release (the dead, unresponsive collapse gesture). The thread stays at
+        // 0 (nothing to size below the input).
+        if (!sheetOpen && offset < 0) {
+            const down = -offset;
+            openProgress.set(Math.max(0, 1 - down / PILL_OPEN_DISTANCE));
+            threadHeight.set(0);
+            return;
+        }
+        // Pin the dead direction at each end so the panel feels held: collapsed →
+        // only upward (positive); full → only downward (negative); half → both.
+        const off = !sheetOpen
+            ? Math.max(0, offset)
+            : expanded
+                ? Math.min(0, offset)
+                : offset;
+        threadHeight.set(clampHeight(baseH + off));
+    }, [
+        pilled,
+        sheetOpen,
+        expanded,
+        baseH,
+        clampHeight,
+        threadHeight,
+        openProgress,
+        stopThreadAnimation,
+        stopOpenProgressAnimation,
+    ]);
+    const pullBinding = usePullGesture({
+        onDrag: onDragOffset,
+        // Pulls STEP one detent at a time (peek→half→full and back) rather than
+        // jumping straight to the ends — the iOS sheet feel. The inline closures are
+        // rebuilt every render, so they always read the current detent.
+        onPullUp: () => {
+            if (pilled) {
+                // PILL → INPUT, or straight into the chat when there's history: a flick
+                // up opens. Mirror the slow-drag path so a flick and a slow drag BOTH
+                // reach the chat (no hard stop at the bare input). Releasing draggingRef
+                // first lets the pilled→openProgress effect spring the morph 0→1.
+                draggingRef.current = false;
+                if (hasThread) {
+                    focusThreadRef.current = true;
+                    goToDetent("half");
+                }
+                else {
+                    // Pill → bare input bar (no thread to open into).
+                    setMode("input");
+                    if (reduce) {
+                        stopThreadAnimation();
+                        threadHeight.set(0);
+                    }
+                    else
+                        animateThreadHeight(0);
+                    detentHaptic();
+                }
+                return;
+            }
+            if (!sheetOpen) {
+                if (!hasThread)
+                    return settleDrag();
+                goToDetent("half");
+                focusThreadRef.current = true;
+            }
+            else if (!expanded) {
+                goToDetent("full");
+                focusThreadRef.current = true;
+            }
+            else {
+                settleDrag();
+            }
+        },
+        onPullDown: () => {
+            if (pilled)
+                return settleDrag(); // already the lowest detent
+            // Step down ONE detent based on the EFFECTIVE height (so a free-rest above
+            // half steps to half first, never skipping it). A downward flick also
+            // closes the keyboard — goToDetent("collapsed") blurs; half-step blurs too.
+            const effectiveH = freeH != null ? Math.min(freeH, panelMaxH) : detentH;
+            if (sheetOpen && effectiveH > halfH + 1) {
+                inputRef.current?.blur();
+                goToDetent("half");
+            }
+            else if (sheetOpen) {
+                goToDetent("collapsed");
+            }
+            else {
+                // INPUT → PILL: collapse the input away into a pill at the bottom.
+                setMode("pill");
+                setMaximized(false);
+                draggingRef.current = false;
+                inputRef.current?.blur();
+                detentHaptic();
+            }
+        },
+        // A tap (no drag) on the handle. A tap on the PILL brings the input back.
+        // When OPEN, the handle is the bar ABOVE the thread, so tapping it with the
+        // keyboard up dismisses it and returns to the pre-focus resting state.
+        // When COLLAPSED the handle's hit zone OVERLAPS the composer, so a tap there
+        // is just "focus to type" — it must only focus the input, never dismiss or
+        // collapse (the native focus already raised the keyboard, and the tap pierces
+        // through to the input). Tapping OUTSIDE the panel is what drops the keyboard.
+        onTap: () => {
+            if (pilled) {
+                openFromPill();
+                return;
+            }
+            if (sheetOpen) {
+                const composerFocused = typeof document !== "undefined" &&
+                    document.activeElement === inputRef.current;
+                // Keyboard up → drop it and return to the pre-focus resting state (an
+                // already-open sheet stays open; an auto-opened one re-collapses).
+                // Keyboard down → the grabber is just the open chat's top bar; a tap
+                // there does nothing (collapse is a pull-down / Escape / scrim tap).
+                if (composerFocused)
+                    dismissKeyboardToPriorState();
+                return;
+            }
+            inputRef.current?.focus();
+        },
+        // A deliberate (slow) drag: REST exactly where released instead of snapping
+        // to a detent — drag the sheet to any size and it stays.
+        onSettleFree: (direction) => {
+            draggingRef.current = false;
+            if (pilled) {
+                // From the pill: a slow drag under the halfway-open mark (openProgress
+                // < 0.5) springs back to the capsule; past it we commit to LEAVING the
+                // pill — but we must NOT force the half detent. A short pull only forms
+                // the input bar (threadHeight stays ~0 until the drag exceeds
+                // PILL_OPEN_DISTANCE), so clear `pilled` and FALL THROUGH to the shared
+                // detent magnetism below: a release near the input (threadHeight within
+                // SHEET_DETENT_MAGNET of 0) settles at the INPUT state, and only a pull
+                // that actually reached up into the thread opens to half/full. This is
+                // what makes pill → input → chat one continuum instead of skipping the
+                // input state straight to half on a short slow pull.
+                const opened = direction === "up" && openProgress.get() >= 0.5;
+                if (!opened) {
+                    settleDrag(); // springs openProgress → 0 (mode stays "pill") + thread → 0
+                    return;
+                }
+                // Leaving the pill: fall through to the magnetism below, which sets the
+                // mode (input / half / full) from where the drag was released — so pill →
+                // input → chat reads as one continuum.
+                if (hasThread)
+                    focusThreadRef.current = true;
+            }
+            // From the collapsed input, a downward drag has nothing to "size" below
+            // it — collapse straight to the pill (matches the flick-down path).
+            if (!sheetOpen && direction === "down") {
+                setMode("pill");
+                inputRef.current?.blur();
+                detentHaptic();
+                return;
+            }
+            const h = Math.max(0, Math.min(threadHeight.get(), panelMaxH));
+            // DETENT MAGNETISM — the resting positions are the detents {collapsed:0,
+            // half, full}; a release within SHEET_DETENT_MAGNET of one snaps to it
+            // (deterministic, no janky near-detent slivers), and only the clear gaps
+            // between them keep the free-drag rest height. goToDetent commits the
+            // honest flags so data-detent + the maximize header match the height.
+            if (h <= SHEET_DETENT_MAGNET) {
+                // Near the bottom → collapse to the input peek.
+                closeSheet();
+                return;
+            }
+            focusThreadRef.current = true;
+            if (h >= openH - SHEET_DETENT_MAGNET) {
+                goToDetent("full");
+            }
+            else if (Math.abs(h - halfH) <= SHEET_DETENT_MAGNET) {
+                goToDetent("half");
+            }
+            else {
+                // In a gap between detents → rest exactly where released. `half` is the
+                // open base; `freeH` overrides the actual height to where the finger left.
+                setFreeH(h);
+                setMode("half");
+            }
+        },
+    });
+    // NOTE: the chat has NO close-on-outside-pointerdown beyond the keyboard blur;
+    // it COLLAPSES on a pull-down, Escape, or a click on the dimming scrim.
+    return (_jsxs("div", { ref: overlayRef, className: cn("pointer-events-none fixed inset-x-0 bottom-0 flex w-full min-w-0 flex-col items-center", 
+        // Full-bleed (maximized) removes the side inset so the chat is edge-to-edge.
+        fullBleed ? "px-0" : "px-3 sm:px-4"), 
+        // Lift the whole overlay above the on-screen keyboard (`bottom`); padding
+        // below the composer is conditional: when the composer is FOCUSED (keyboard
+        // up), only a small gap (0.75rem, matching the side margin) sits between the
+        // composer and the keyboard — the home-gesture clearance isn't needed
+        // because the keyboard covers it. At rest, clear the home-gesture zone (max
+        // safe-area / android inset) plus a hair, keeping the chat low without
+        // touching that zone.
+        style: {
+            zIndex: Z_SHELL_OVERLAY,
+            bottom: effectiveKeyboardInset,
+            // Full-bleed fills the screen edge-to-edge: NO overlay bottom padding,
+            // so the glass panel reaches the true bottom (no orange gap). The
+            // gesture-zone clearance moves INSIDE the composer row (below) so the
+            // input still sits above the home-gesture bar. Non-full-bleed keeps the
+            // chat lifted off the gesture zone as before.
+            paddingBottom: fullBleed
+                ? 0
+                : composerFocused
+                    ? "0.75rem"
+                    : "calc(var(--eliza-mobile-nav-offset, 0px) + max(var(--safe-area-bottom, 0px), var(--android-gesture-inset-bottom, 0px)) + 0.25rem)",
+        }, "data-testid": "continuous-chat-overlay", "data-open": sheetOpen ? "true" : undefined, children: [_jsx(motion.div, { "aria-hidden": "true", "data-testid": "chat-sheet-backdrop", "data-active": sheetOpen ? "true" : "false", onClick: sheetOpen
+                    ? () => {
+                        // First tap with the keyboard up only dismisses it (the
+                        // pointerdown handler already dropped the keyboard and restored
+                        // the pre-focus detent) — don't ALSO collapse. A tap with the
+                        // keyboard already down closes the chat back to the input.
+                        if (composerFocusedAtPressRef.current) {
+                            composerFocusedAtPressRef.current = false;
+                            return;
+                        }
+                        collapse();
+                    }
+                    : undefined, className: "fixed inset-0 bg-[linear-gradient(160deg,rgba(255,255,255,0.06)_0%,rgba(8,10,18,0.55)_46%,rgba(0,0,0,0.66)_100%)]", 
+                // Opacity follows the live history height (motion value) — no re-render
+                // during a drag. Capture clicks only once open.
+                style: {
+                    opacity: revealed,
+                    visibility: scrimVisibility,
+                    pointerEvents: sheetOpen ? "auto" : "none",
+                } }), recording && transcript ? (_jsxs("div", { role: "status", "aria-live": "polite", "aria-atomic": "true", className: cn("pointer-events-none relative mb-2 w-full max-w-3xl text-center text-sm italic text-white/85", FLOAT_SHADOW), children: [transcript, _jsx("span", { "aria-hidden": "true", children: "\u2026" })] })) : null, needsAudioUnlock ? (_jsx("div", { role: "status", "aria-live": "polite", className: "pointer-events-none relative mb-2 flex w-full justify-center", children: _jsxs("button", { type: "button", onClick: unlockAudio, "data-testid": "overlay-voice-audio-unlock", className: cn("pointer-events-auto inline-flex items-center gap-1.5 rounded-full border px-3 py-1.5 text-sm font-medium transition-colors", "border-warn/40 bg-warn/15 text-warn hover:bg-warn/25", "  ", FLOAT_SHADOW), children: [_jsx(Glyph, { d: SPEAKER_MUTED_GLYPH }), _jsx("span", { children: "Tap to enable sound" })] }) })) : null, modelStatus.kind === "downloading" || modelStatus.kind === "loading" ? (_jsx("div", { role: "status", "aria-live": "polite", "aria-atomic": "true", "data-testid": "overlay-model-download-status", className: "pointer-events-none relative mb-2 flex w-full justify-center", children: _jsxs("span", { className: cn("inline-flex items-center gap-2 rounded-full border border-white/15 bg-white/10 px-3 py-1.5 text-sm font-medium text-white/85", FLOAT_SHADOW), children: [_jsx(Loader2, { className: "h-3.5 w-3.5 animate-spin text-[#FF5800]" }), modelStatus.kind === "downloading" ? (_jsxs("span", { children: ["Downloading ", modelStatus.modelName ?? "local model", typeof modelStatus.percent === "number"
+                                    ? ` — ${Math.round(modelStatus.percent)}%`
+                                    : "…"] })) : (_jsxs("span", { children: ["Loading ", modelStatus.modelName ?? "local model", "\u2026"] }))] }) })) : null, suggestionsVisible ? (_jsx(motion.fieldset, { "aria-label": "Suggested prompts", className: cn("pointer-events-auto relative m-0 mb-2 flex w-full max-w-3xl flex-wrap items-center justify-center gap-2 border-0 p-0"), style: { order: -1, opacity: suggestionsOpacity }, "data-testid": "chat-suggestions", children: suggestions.map((s, i) => (_jsx("button", { type: "button", "data-testid": `chat-suggestion-${i}`, "aria-label": s, onClick: () => pickSuggestion(s), className: cn("max-w-full truncate rounded-full border border-white/15 bg-black/40 px-3 py-1.5", "text-[12px] text-white/80 transition-colors", "hover:border-white/30 hover:bg-white/15 hover:text-white", "  "), children: s }, s))) })) : null, _jsxs("div", { className: cn("pointer-events-none relative flex w-full flex-col items-center", fullBleed ? "max-w-none" : "max-w-3xl"), children: [!fullBleed ? (_jsx(SheetGrabber, { open: sheetOpen, onOpen: () => {
+                            if (!hasThread)
+                                return;
+                            goToDetent("half");
+                            focusThreadRef.current = true;
+                        }, onClose: collapse, binding: pullBinding, glow: listening || responding, opacity: grabberOpacity, pilled: pilled })) : null, _jsxs(motion.fieldset, { ref: panelRef, "aria-label": "Chat composer", "data-testid": "chat-sheet", "data-variant": sheetOpen ? "open" : "closed", "data-detent": pilled
+                            ? "pill"
+                            : !sheetOpen
+                                ? "collapsed"
+                                : freeH != null
+                                    ? Math.min(freeH, panelMaxH) >= openH - 1
+                                        ? "full"
+                                        : "half"
+                                    : expanded
+                                        ? "full"
+                                        : "half", "data-maximized": fullBleed ? "true" : undefined, "data-revealed": sheetOpen ? "true" : "false", "data-chat-state": chatState, "data-header-shown": headerVisible ? "true" : "false", 
+                        // ONE persistent element across pill ↔ input ↔ chat (never remounts —
+                        // that pop was the core jank). It's a transparent scale/position
+                        // container; the liquid glass lives in an inner layer faded by
+                        // openProgress, so pill → input is a continuous scale + crossfade.
+                        // maxHeight keeps it from spilling off the top (thread scrolls instead).
+                        style: {
+                            maxHeight: panelMaxH,
+                            // Full-bleed must be exactly scale 1 — a sub-1 morph scale with a
+                            // bottom transform-origin would drop the top edge below the status
+                            // bar (the "gap at the top when maximized" bug).
+                            scale: fullBleed ? 1 : panelScale,
+                            // Grow UP out of the pill at the bottom.
+                            transformOrigin: "bottom center",
+                            // Pilled: span the (invisible) input area but pass taps through to the
+                            // home screen — only the pill-capsule child re-enables pointer events.
+                            pointerEvents: pilled ? "none" : "auto",
+                        }, className: cn(
+                        // overflow-VISIBLE on the outer fieldset: the pill's tall grab zone
+                        // must bleed past the box. The rounded thread-clip lives on the inner
+                        // content wrapper instead, so clipping the scroll never clips a hard
+                        // square edge over the content.
+                        "relative m-0 flex w-full min-w-0 flex-col overflow-visible border-0 p-0"), children: [_jsx(motion.div, { "aria-hidden": "true", className: cn("pointer-events-none absolute inset-0 z-0", fullBleed ? "border-0" : "border border-white/[0.16]", 
+                                // A solid dark fill so white text stays legible over any view
+                                // behind (a bright view, a dark view, or the warm ambient field).
+                                "bg-black/45"), style: {
+                                    opacity: glassOpacity,
+                                    borderRadius: fullBleed ? 0 : panelRadius,
+                                    // Full-bleed: extend the glass UP through the safe-area-top so the
+                                    // dark background reaches the true top of the screen. The panel
+                                    // height comes from visualViewport (which excludes the Android
+                                    // status bar) while the panel sits in a screen-top fixed container,
+                                    // so without this the glass starts a status-bar-height below the top
+                                    // (the "safe-area gap" above maximized chat). overflow-visible on the
+                                    // panel lets it bleed up; content (header, with its own safe-area
+                                    // padding) is untouched. Harmless when the inset is 0.
+                                    ...(fullBleed
+                                        ? { top: "calc(-1 * env(safe-area-inset-top, 0px))" }
+                                        : null),
+                                } }), _jsxs(motion.div, { ref: contentRef, "data-testid": "chat-content", inert: pilled || undefined, 
+                                // overflow-hidden + the live radius clips the sheen/thread to the
+                                // panel's rounded shape (the clip the fieldset used to do) WITHOUT
+                                // touching the sibling glass layer's shadow.
+                                className: "relative z-10 flex min-h-0 w-full flex-col overflow-hidden", style: {
+                                    opacity: glassOpacity,
+                                    pointerEvents: pilled ? "none" : "auto",
+                                    borderRadius: fullBleed ? 0 : panelRadius,
+                                }, children: [sheetOpen ? (_jsxs(_Fragment, { children: [_jsx(SwipeEdgeHint, { side: "left", active: swipeDx < 0 && conversationNav.hasPrev, amount: -swipeDx }), _jsx(SwipeEdgeHint, { side: "right", active: swipeDx > 0 && conversationNav.hasNext, amount: swipeDx })] })) : null, _jsx("div", { "aria-hidden": "true", className: "pointer-events-none absolute inset-x-0 top-0 z-0 h-20 bg-gradient-to-b from-white/[0.07] to-transparent" }), !pilled ? (_jsxs(motion.div
+                                    // Always mounted (when not pilled) so it can FADE + LERP its
+                                    // space open/closed with the live height instead of popping in
+                                    // on a mount. `headerVisible` (live-height boolean) gates
+                                    // interactivity + the a11y tree so the faded/collapsed header
+                                    // can't be clicked or read.
+                                    , { 
+                                        // Always mounted (when not pilled) so it can FADE + LERP its
+                                        // space open/closed with the live height instead of popping in
+                                        // on a mount. `headerVisible` (live-height boolean) gates
+                                        // interactivity + the a11y tree so the faded/collapsed header
+                                        // can't be clicked or read.
+                                        inert: !headerVisible || undefined, style: {
+                                            // Full-bleed is always fully open: show the header at full
+                                            // opacity and UNCAP its height. The reveal lerp tops out at
+                                            // 100px, but the safe-area top padding (status-bar height +
+                                            // 0.5rem) plus the button row exceeds that, so a 100px cap
+                                            // clipped the buttons — uncap it edge-to-edge.
+                                            opacity: fullBleed ? 1 : headerOpacity,
+                                            maxHeight: fullBleed ? "none" : headerMaxH,
+                                            // Collapsed → 0 top padding (no leaked margin above the
+                                            // composer); opens to ~10px as the header reveals. Maximized
+                                            // goes edge-to-edge under the status bar, so the header insets
+                                            // its buttons below the safe area (the clock/battery) while the
+                                            // sheet bg stays full-bleed — set inline (not a Tailwind
+                                            // arbitrary class, whose env(...,0px) comma breaks the parser
+                                            // so no padding was generated and the buttons sat under the
+                                            // status bar).
+                                            paddingTop: fullBleed
+                                                ? "calc(var(--safe-area-top, 0px) + 0.5rem)"
+                                                : headerPadTop,
+                                        }, className: cn("relative z-10 flex shrink-0 items-center justify-between gap-1.5 overflow-hidden px-3"), children: [_jsxs("div", { className: "flex items-center gap-1.5", children: [_jsx(HeaderButton, { icon: maximized ? Minimize2 : Maximize2, label: maximized ? "exit full screen" : "full screen", active: maximized, onClick: toggleMaximize, testId: "chat-full-maximize" }), hasThread ? (_jsx(HeaderButton, { icon: conversationCopied ? Check : Copy, label: conversationCopied
+                                                            ? "conversation copied"
+                                                            : "copy conversation", onClick: handleCopyConversation, testId: "chat-full-copy-conversation" })) : null, _jsx(HeaderButton, { icon: RotateCcw, label: "clear conversation", onClick: () => clearConversation(), testId: "chat-full-clear" })] }), transcriptionMode ? (_jsx("div", { "data-testid": "chat-transcribing-badge", className: "pointer-events-none absolute left-1/2 top-1/2 -translate-x-1/2 -translate-y-1/2 whitespace-nowrap rounded-full bg-[var(--brand-orange,#ff6a00)]/15 px-2.5 py-0.5 text-[11px] font-medium text-[var(--brand-orange,#ff6a00)]", children: "Transcribing \u2014 say \u201Cexit transcription mode\u201D to stop" })) : null, _jsx("div", { className: "flex items-center gap-1.5", children: _jsx(HeaderButton, { icon: LayoutGrid, label: "springboard", onClick: () => navigateAndClose(() => navigateHome?.()), testId: "chat-full-springboard" }) })] })) : null, hasThread || sheetOpen ? (_jsx(motion.div, { "data-testid": "chat-thread", className: cn("relative z-10 min-h-0 w-full shrink grow-0 overflow-hidden", 
+                                        // When open, fade the top edge into the glass so the topmost
+                                        // message dissolves under the drag handle instead of butting
+                                        // against it.
+                                        sheetOpen &&
+                                            "[mask-image:linear-gradient(to_bottom,transparent_0,#000_34px)] [-webkit-mask-image:linear-gradient(to_bottom,transparent_0,#000_34px)]"), 
+                                        // Flex-basis IS the motion value (px string) — set 1:1 during a drag,
+                                        // spring-animated to a detent on release; no `animate`/`transition`,
+                                        // so no re-render. `shrink min-h-0` lets the panel's `maxHeight` cap
+                                        // win: a tall detent (or the keyboard) shrinks the thread (it
+                                        // scrolls) instead of pushing the panel off-screen. paddingTop
+                                        // insets the scroll viewport below the floating grabber while the
+                                        // header is hidden (0 once the header reveals at half+).
+                                        style: {
+                                            flexBasis: threadFlexBasis,
+                                            paddingTop: threadGrabberClearance,
+                                        }, children: _jsxs("div", { id: "continuous-thread", ref: threadRef, role: "log", "aria-label": "conversation history", "aria-live": "polite", "aria-hidden": !sheetOpen ? true : undefined, tabIndex: sheetOpen ? 0 : -1, onKeyDown: (e) => {
+                                                if (e.key === "Escape") {
+                                                    e.preventDefault();
+                                                    collapse();
+                                                }
+                                            }, ...(sheetOpen ? conversationSwipe : {}), className: "relative flex h-full w-full touch-pan-y flex-col overflow-y-auto px-5 [scrollbar-width:none]  [&::-webkit-scrollbar]:hidden", children: [visibleMessages.length === 0 && conversationLoading ? (_jsx("div", { "data-testid": "chat-thread-loading", className: "pointer-events-none absolute inset-0 grid place-items-center", children: _jsx(Loader2, { className: "h-6 w-6 animate-spin text-[#FF5800]" }) })) : null, hasTopics ? (_jsx(TopicChipsBar, { topics: channelTopics, onSelectTopic: scrollToTopic, className: "sticky top-0 z-[2] -mx-5 mb-1 bg-gradient-to-b from-black/40 to-transparent px-5" })) : null, _jsxs("div", { className: "mt-auto flex flex-col pb-3 pt-1", children: [hasTopics
+                                                            ? // Topic-grouped transcript: each cluster collapses via a
+                                                                // gesture on its header (no visible buttons).
+                                                                (() => {
+                                                                    let lineIndex = 0;
+                                                                    return topicSegments.map((segment) => {
+                                                                        const lines = segment.messages.map((m) => renderThreadLine(m, lineIndex++));
+                                                                        return (_jsx(TopicGroup, { topic: segment.topic, count: segment.messages.length, collapsed: collapsedTopics.has(segment.key), onCollapsedChange: (collapsed) => setTopicCollapsed(segment.key, collapsed), children: _jsx(AnimatePresence, { initial: false, children: lines }) }, segment.messages[0]?.id ?? segment.key));
+                                                                    });
+                                                                })()
+                                                            : // Flat transcript (no topic tags) — unchanged behavior.
+                                                                // Only the LAST, content-less assistant turn (the
+                                                                // in-flight one) reads turnStatus — every settled bubble
+                                                                // gets undefined so its memo identity is unchanged.
+                                                                null, hasTopics ? null : (_jsx(AnimatePresence, { initial: false, children: visibleMessages.map((m, i) => renderThreadLine(m, i)) })), _jsx(AnimatePresence, { children: responding &&
+                                                                !(visibleMessages.at(-1)?.role === "assistant" &&
+                                                                    !visibleMessages.at(-1)?.content.trim()) ? (_jsx(TurnStatusIndicator, { status: turnStatus, reduce: reduce })) : null }), _jsx("div", { ref: endRef })] })] }) })) : null, hasImages || imageError ? (_jsxs("div", { className: "relative z-10 flex shrink-0 flex-col gap-1.5 px-3 pt-2", children: [hasImages ? (_jsx("div", { className: "flex flex-wrap gap-2", children: pendingImages.map((img, i) => {
+                                                    const kind = chatUploadKind(img.mimeType);
+                                                    const removeButton = (_jsx("button", { type: "button", "aria-label": `remove ${img.name}`, onClick: () => removeImage(i), 
+                                                        // Small visual disc, but a 44px-class hit zone via the
+                                                        // invisible `before` overlay so it's thumb-tappable
+                                                        // without crowding the tile.
+                                                        className: "absolute -right-1.5 -top-1.5 grid h-5 w-5 place-items-center rounded-full border border-white/20 bg-black/70 text-xs text-white/90 transition-colors before:absolute before:-inset-3 before:content-[''] hover:bg-black/90", children: "\u00D7" }));
+                                                    const tileKey = `${img.name}-${img.mimeType}-${img.data.length}`;
+                                                    if (kind === "image") {
+                                                        return (_jsxs("div", { className: "group relative h-14 w-14 shrink-0", children: [_jsx("img", { src: `data:${img.mimeType};base64,${img.data}`, alt: img.name, className: "h-14 w-14 rounded-lg border border-white/20 object-cover" }), removeButton] }, tileKey));
+                                                    }
+                                                    const KindIcon = kind === "audio"
+                                                        ? Music
+                                                        : kind === "video"
+                                                            ? Film
+                                                            : FileText;
+                                                    return (_jsxs("div", { className: "group relative flex h-14 min-w-[3.5rem] max-w-[10rem] shrink-0 items-center gap-2 rounded-lg border border-white/20 bg-white/10 px-2.5 text-white/90", title: img.name, children: [_jsx(KindIcon, { className: "h-5 w-5 shrink-0 text-white/70" }), _jsx("span", { className: "min-w-0 truncate text-[11px] leading-tight", children: img.name }), removeButton] }, tileKey));
+                                                }) })) : null, imageError ? (_jsx("p", { role: "alert", className: cn("text-xs text-red-200/90", FLOAT_SHADOW), children: imageError })) : null] })) : null, _jsx("input", { ref: fileInputRef, type: "file", accept: CHAT_UPLOAD_ACCEPT, multiple: true, className: "hidden", onChange: (e) => {
+                                            if (e.target.files)
+                                                addImageFiles(e.target.files);
+                                            e.target.value = "";
+                                        } }), _jsxs("div", { className: cn(
+                                        // items-center vertically centers a single-line composer with
+                                        // the round +/mic buttons (the common case); a multi-line draft
+                                        // grows the textarea and the buttons stay centered. shrink-0
+                                        // keeps the input fully visible when the panel hits its
+                                        // maxHeight cap (only the thread above gives way).
+                                        // Equal inset on all sides (px == py): a round button nested in
+                                        // the pill's round end-cap reads as concentric, with the same
+                                        // gap on the sides as top/bottom.
+                                        "relative z-10 flex min-w-0 shrink-0 items-center gap-1.5 px-2 py-2 sm:gap-2", sheetOpen ? "border-t border-white/10" : ""), 
+                                        // Full-bleed has no overlay bottom padding (the panel is
+                                        // edge-to-edge), so the composer carries the home-gesture
+                                        // clearance itself — except while the keyboard is up, which
+                                        // already covers that zone.
+                                        style: fullBleed && !composerFocused
+                                            ? {
+                                                paddingBottom: "calc(0.5rem + max(var(--safe-area-bottom, 0px), var(--android-gesture-inset-bottom, 0px)))",
+                                            }
+                                            : undefined, children: [slashProp && !slashDismissed ? (_jsx(SlashCommandMenu, { state: slashMenu, loading: isSlashDraft && slash.loading, onPick: pickSlashItem })) : null, _jsx(SoftButton, { glyph: PLUS_GLYPH, label: "attach image", disabled: pendingImages.length >= MAX_CHAT_IMAGES, onClick: () => fileInputRef.current?.click(), testId: "chat-composer-attach" }), _jsx("textarea", { ref: inputRef, rows: 1, value: draft, onChange: (e) => {
+                                                    setDraft(e.target.value);
+                                                    // Mirror the live draft to the active view (Help search etc.).
+                                                    viewChatBinding?.onQuery?.(e.target.value);
+                                                    if (e.target.value.trim().length > 0)
+                                                        expand();
+                                                }, onFocus: () => {
+                                                    setComposerFocused(true);
+                                                    // A pill-open focus only raises the keyboard; it must not
+                                                    // expand a history thread (see suppressExpandOnFocusRef).
+                                                    if (suppressExpandOnFocusRef.current) {
+                                                        suppressExpandOnFocusRef.current = false;
+                                                    }
+                                                    else {
+                                                        expand();
+                                                    }
+                                                }, onBlur: () => setComposerFocused(false), onPaste: (e) => {
+                                                    // Shared with the desktop composer: a pasted image/file
+                                                    // attaches, a large plain-text paste becomes a collapsed
+                                                    // text-attachment chip, and small text falls through to the
+                                                    // textarea as normal.
+                                                    const intent = classifyComposerPaste({
+                                                        files: Array.from(e.clipboardData?.files ?? []),
+                                                        text: e.clipboardData?.getData("text") ?? "",
+                                                    });
+                                                    if (intent.kind === "files") {
+                                                        e.preventDefault();
+                                                        addImageFiles(intent.files);
+                                                        return;
+                                                    }
+                                                    if (intent.kind === "text-attachment") {
+                                                        e.preventDefault();
+                                                        setPendingImages((prev) => [...prev, intent.attachment].slice(0, MAX_CHAT_IMAGES));
+                                                    }
+                                                }, onKeyDown: (e) => {
+                                                    // The slash menu intercepts navigation/commit keys when open.
+                                                    if (slashOpen) {
+                                                        if (e.key === "ArrowDown") {
+                                                            e.preventDefault();
+                                                            slashMenu.move(1);
+                                                            return;
+                                                        }
+                                                        if (e.key === "ArrowUp") {
+                                                            e.preventDefault();
+                                                            slashMenu.move(-1);
+                                                            return;
+                                                        }
+                                                        if (e.key === "Tab") {
+                                                            const completed = slashMenu.complete();
+                                                            if (completed != null) {
+                                                                e.preventDefault();
+                                                                setDraft(completed);
+                                                                return;
+                                                            }
+                                                        }
+                                                        if (e.key === "Enter" && !e.shiftKey) {
+                                                            const exec = slashMenu.resolve();
+                                                            if (exec) {
+                                                                e.preventDefault();
+                                                                runExecution(exec);
+                                                                return;
+                                                            }
+                                                        }
+                                                        if (e.key === "Escape") {
+                                                            e.preventDefault();
+                                                            e.stopPropagation();
+                                                            setSlashDismissed(true);
+                                                            return;
+                                                        }
+                                                    }
+                                                    // Enter sends; Shift+Enter inserts a newline (multi-line compose).
+                                                    if (e.key === "Enter" && !e.shiftKey) {
+                                                        e.preventDefault();
+                                                        submit();
+                                                    }
+                                                    else if (e.key === "Escape" && sheetOpen) {
+                                                        e.preventDefault();
+                                                        collapse();
+                                                    }
+                                                }, placeholder: booting
+                                                    ? `Ask ${agentName} — waking up…`
+                                                    : (viewChatBinding?.placeholder ?? `Ask ${agentName}`), "aria-label": "message", "data-testid": "chat-composer-textarea", "aria-describedby": booting ? "cc-booting-hint" : undefined, ...comboboxAria, className: "max-h-[8.5rem] min-h-8 min-w-0 flex-1 resize-none self-center border-none bg-transparent px-1.5 py-1 text-left text-sm leading-relaxed text-white/[0.92] outline-none [scrollbar-width:none] placeholder:text-white/45 [&::-webkit-scrollbar]:hidden" }), _jsxs("span", { id: "cc-booting-hint", className: "sr-only", children: [agentName, " is waking up \u2014 you can type now; your message sends and the reply arrives in a moment."] }), _jsx("div", { className: "flex shrink-0 items-center gap-1.5 sm:gap-2", children: _jsx("div", { className: "shrink-0", children: (hasDraft || hasImages) && !recording ? (_jsx(SoftButton, { icon: SendHorizontal, label: !canSend
+                                                            ? "send (agent stopped)"
+                                                            : responding
+                                                                ? "send another"
+                                                                : "send", disabled: !canSend, 
+                                                        // Keep focus in the textarea on tap: without this the
+                                                        // button steals focus, the textarea blurs, the keyboard
+                                                        // retracts and the composer relayouts between pointerdown
+                                                        // and click — so the first tap only dismissed the keyboard
+                                                        // and a second tap was needed to actually send. Chromium
+                                                        // still dispatches click after a preventDefaulted
+                                                        // pointerdown, so onClick fires on the first tap and the
+                                                        // keyboard stays up for the next message.
+                                                        onPointerDown: (e) => e.preventDefault(), onClick: submit, testId: "chat-composer-action" })) : !recording && responding ? (_jsx(SoftButton, { glyph: STOP_GLYPH, label: "stop generating", onClick: () => stop(), testId: "chat-composer-stop" })) : (_jsx(SoftButton, { icon: Mic, label: pttHolding
+                                                            ? "release to send"
+                                                            : transcriptionMode
+                                                                ? "stop transcription"
+                                                                : handsFree
+                                                                    ? "end conversation"
+                                                                    : recording
+                                                                        ? "stop listening"
+                                                                        : "talk", active: recording || handsFree || transcriptionMode, onClick: handleMicClick, onPointerDown: beginPushToTalkPress, onPointerUp: (e) => finishPushToTalkPress(e, false), onPointerCancel: (e) => finishPushToTalkPress(e, true), testId: "chat-composer-mic" })) }) })] })] }), _jsx(motion.div, { className: "absolute inset-x-0 bottom-0 z-30 flex justify-center", style: {
+                                    opacity: pillOpacity,
+                                    pointerEvents: pilled ? "auto" : "none",
+                                }, children: _jsx(PillHandle, { binding: pullBinding, onOpen: openFromPill, glow: listening || responding, pilled: pilled }) })] })] })] }));
+}