@teaflask/assistant 0.3.0 → 0.6.0

package/dist/components/companion-drawer-body.js

@@ -8,39 +8,20 @@ import { servedSuggestionsForPath } from "./served-suggestions.js";
 import { useAssistantSession } from "./teaflask-assistant-provider.js";
 import { useAssistantConversation } from "./use-assistant-conversation.js";
 import { useCell } from "./use-store-cell.js";
-// The drawer's conversation half — the one companion module that
-// reaches the transcript (and through it the chat chassis). Loaded ONLY
-// through the drawer's dynamic import: the minimized companion's static
-// graph must stay transcript-free (the bundle-closure test enforces it),
-// so a page that only ever shows the mark never downloads the chat.
-// Default export because React.lazy wants one.
 export default function CompanionDrawerBody() {
     const core = useAssistantConversation();
-    // The drawer's opening prompts: the host's provider prop when one was
-    // passed (explicit JS intent wins wholesale, even an empty array), the
-    // sets authored on the org's assistant otherwise — the drawer is the
-    // surface a visitor meets first, so it is where the welcome earns its
-    // prompts; the page keeps taking them as its own prop.
     const { suggestions } = useAssistantAppearance();
     const { assistantConfig, ensureAssistantConfig } = useAssistantSession();
     const served = useCell(assistantConfig);
-    // Re-adopt the stored thread on every open (the body mounts per open,
-    // palette parity): another surface may have moved the conversation
-    // while the drawer was closed, and expanding must mean "continue
-    // where I am".
     const resumeStoredThread = core.resumeStoredThread;
     useEffect(() => {
         resumeStoredThread();
     }, [resumeStoredThread]);
-    // Only a drawer the host left promptless ever fetches: a passed prop
-    // means the served config could never render, so no one pays for it.
     useEffect(() => {
         if (suggestions === null) {
             ensureAssistantConfig();
         }
     }, [suggestions, ensureAssistantConfig]);
-    // The pathname is read per render, not subscribed: the empty state
-    // re-renders on every open, which is exactly when the answer matters.
     const effectiveSuggestions = suggestions ??
         (served === null
             ? undefined
@@ -48,10 +29,5 @@ export default function CompanionDrawerBody() {
     if (core.setupError !== null) {
         return (_jsx("div", { className: "tf:flex tf:flex-1 tf:items-center tf:justify-center tf:p-6", children: _jsx(SetupErrorState, { message: core.setupError.message, code: core.setupError.code }) }));
     }
-    return (_jsx(ConversationView, { core: core, surface: "companion", suggestions: effectiveSuggestions, 
-        // The mark is decorative — the greeting under it is the content.
-        // The span is the stylesheet's sizing hook: static, deliberately
-        // unpositioned, so nothing ever paints over the header's menu.
-        welcomeMark: _jsx("span", { "aria-hidden": true, "data-tf-companion-welcome-mark": "", children: _jsx(CompanionMark, {}) }) }));
+    return (_jsx(ConversationView, { core: core, surface: "companion", suggestions: effectiveSuggestions, welcomeMark: _jsx("span", { "aria-hidden": true, "data-tf-companion-welcome-mark": "", children: _jsx(CompanionMark, {}) }) }));
 }
-//# sourceMappingURL=companion-drawer-body.js.map

package/dist/components/companion-drawer.d.ts

@@ -1,21 +1,10 @@
 import type { PanelDock } from "../persistence/panel-mode.js";
 export declare function CompanionDrawer({ open, exiting, focusOnOpen, onOpenChange, corner, dock, onDockChange, }: {
     open: boolean;
-    /** The open is the visitor's own gesture, so the caret may land in the
-     *  composer; false for an open written from outside (a tool
-     *  navigation), which must leave focus where it is. */
     focusOnOpen: boolean;
-    /** The parent is holding the unmount so the close transition can
-     *  paint; the body stays for the ride so the card leaves whole, not
-     *  as a gutted header-only shell. */
     exiting: boolean;
     onOpenChange: (open: boolean) => void;
     corner: "bottom-right" | "bottom-left";
-    /** The effective mode, already viewport-resolved by the parent — the
-     *  drawer never reads persistence or measures the window. */
     dock: PanelDock;
-    /** Null hides the switcher: the viewport is below the sidebar's floor
-     *  and the parent already forced floating. */
     onDockChange: ((dock: PanelDock) => void) | null;
 }): import("react").JSX.Element;
-//# sourceMappingURL=companion-drawer.d.ts.map

package/dist/components/companion-drawer.js

@@ -9,25 +9,6 @@ import { LazyBody } from "./lazy-body.js";
 import { TfButton } from "./primitives/button.js";
 import { TfFloatingPanel } from "./primitives/floating-panel.js";
 import { useAssistantConversation } from "./use-assistant-conversation.js";
-// The companion's corner chat drawer: the non-modal TfFloatingPanel with
-// a real header — the visible grabber (swipe-to-dismiss starts only on
-// the handle, and an invisible handle is no touch affordance at all), a
-// title, and the controls. On the left the title IS the history
-// disclosure: the active conversation's name with a chevron, dropping
-// open the same list the page's rail shows — where you are and where
-// you've been are one affordance. On the right, compose starts a fresh
-// conversation, and the close control is a minimize dash, not an X:
-// dismissing the drawer collapses it back into the perch — the
-// conversation and the companion both survive — and an X would promise a
-// destruction that never happens. The title sits at the muted label step
-// so the empty state's centered question stays the surface's only
-// headline; the panel's aria-label carries the accessible name
-// regardless.
-//
-// The body is code-split behind the first expand. React.lazy's dynamic
-// import is the mechanism: the minimized companion ships without the
-// transcript (or the chat chassis under it), and the host's bundler
-// splits the chunk without configuration.
 const CompanionDrawerBody = lazy(() => import("./companion-drawer-body.js"));
 export function CompanionDrawer({ open, exiting, focusOnOpen, onOpenChange, corner, dock, onDockChange, }) {
     const { rootProps } = useAssistantAppearance();
@@ -35,8 +16,6 @@ export function CompanionDrawer({ open, exiting, focusOnOpen, onOpenChange, corn
     const menus = useDrawerMenus(onDockChange, onOpenChange);
     return (_jsxs(TfFloatingPanel, { open: open, focusOnOpen: focusOnOpen, onOpenChange: menus.changeOpenAndSettleMenu, corner: corner, dock: dock, "aria-label": "Assistant", ...rootProps, children: [_jsxs("div", { "data-tf-swipe-handle": "", className: "tf:relative tf:flex tf:h-12 tf:shrink-0 tf:items-center tf:gap-1 tf:border-b tf:pr-2 tf:pl-4", children: [_jsx("span", { "aria-hidden": true, "data-tf-companion-grabber": "" }), _jsx(CompanionHeaderTitle, { menuId: menus.historyMenuId, open: menus.historyOpen, onOpenChange: menus.discloseHistory, triggerRef: menus.historyTriggerRef }), core.setupError === null ? (_jsx(NewConversationButton, { onStart: core.startNewConversation })) : null, onDockChange !== null ? (_jsx(CompanionModeTrigger, { menuId: menus.modeMenuId, open: menus.modeMenuOpen, onOpenChange: menus.discloseModeMenu, triggerRef: menus.modeTriggerRef })) : null, _jsx(TfButton, { variant: "icon", "aria-label": "Minimize assistant", title: "Minimize assistant", onClick: menus.minimize, children: _jsx(MinimizeIcon, {}) })] }), open || exiting ? (_jsx(LazyBody, { children: _jsx(CompanionDrawerBody, {}) })) : null, open && menus.historyOpen ? (_jsx(CompanionHistoryMenu, { id: menus.historyMenuId, onClose: menus.closeHistory, triggerRef: menus.historyTriggerRef })) : null, open && menus.modeMenuOpen && onDockChange !== null ? (_jsx(CompanionModeMenu, { id: menus.modeMenuId, dock: dock, triggerRef: menus.modeTriggerRef, onClose: menus.closeModeMenu, onSelect: menus.selectDock })) : null] }));
 }
-/** The header's two disclosures — history and dock mode — open one at a
- *  time, and both taken down by any deliberate dismissal of the drawer. */
 function useDrawerMenus(onDockChange, onOpenChange) {
     const [historyOpen, setHistoryOpen] = useState(false);
     const historyMenuId = useId();
@@ -44,18 +23,9 @@ function useDrawerMenus(onDockChange, onOpenChange) {
     const [modeMenuOpen, setModeMenuOpen] = useState(false);
     const modeMenuId = useId();
     const modeTriggerRef = useRef(null);
-    // The switcher leaving takes its menu down for good — without this, a
-    // menu open when the viewport drops below the sidebar floor would hold
-    // its flag through the unmount and pop back open, unprompted, when the
-    // viewport returns. Render-time adjustment (the sanctioned shape), not
-    // an effect: the flag must never survive into a paint that renders the
-    // trigger expanded.
     if (onDockChange === null && modeMenuOpen) {
         setModeMenuOpen(false);
     }
-    // One disclosure at a time: two dropped-open menus would stack by
-    // paint order and race each other's light dismiss, so opening any
-    // takes the others down.
     function discloseHistory(next) {
         if (next) {
             setModeMenuOpen(false);
@@ -79,17 +49,8 @@ function useDrawerMenus(onDockChange, onOpenChange) {
         if (onDockChange !== null) {
             onDockChange(next);
         }
-        // The pick just re-geometried the whole panel under the
-        // keyboard user; the trigger is the one landmark that stayed
-        // put, so focus comes back to it rather than dying with the
-        // menu row.
         modeTriggerRef.current?.focus();
     }
-    // Every deliberate dismissal — the dash, Esc, a swipe, a forced park —
-    // arrives through this callback, and takes the menus down with the
-    // drawer. A yield to the palette deliberately does NOT: it flips the
-    // open prop without ringing here, and the drawer's contract for a
-    // yield is that everything comes back exactly as it was.
     function changeOpenAndSettleMenu(next) {
         if (!next) {
             setHistoryOpen(false);
@@ -116,17 +77,12 @@ function useDrawerMenus(onDockChange, onOpenChange) {
         minimize,
     };
 }
-/** Compose: a fresh conversation, with the caret handed to the composer. */
 function NewConversationButton({ onStart }) {
     return (_jsx(TfButton, { variant: "icon", "aria-label": "New conversation", title: "New conversation", onClick: (event) => {
             onStart();
-            // The fresh conversation starts with the caret in the
-            // composer, not on this button (palette parity, retargeted:
-            // the drawer's root is the popover div, not a dialog).
             const panel = event.currentTarget.closest("[data-tf-floating-panel]");
             requestAnimationFrame(() => {
                 panel?.querySelector("[data-tf-autofocus]")?.focus();
             });
         }, children: _jsx(ComposeIcon, {}) }));
 }
-//# sourceMappingURL=companion-drawer.js.map

package/dist/components/companion-header-disclosure.d.ts

@@ -1,8 +1,5 @@
 import { type ComponentProps, type ReactNode, type RefObject } from "react";
 import { TfButton } from "./primitives/button.js";
-/** The header-row half: owns the disclosure aria wiring and the
- *  Esc-closes-the-menu-not-the-drawer keydown. Everything else — variant,
- *  className, children — passes through to TfButton. */
 export declare function HeaderDisclosureTrigger({ menuId, open, onOpenChange, triggerRef, children, ...buttonProps }: {
     menuId: string;
     open: boolean;
@@ -10,11 +7,6 @@ export declare function HeaderDisclosureTrigger({ menuId, open, onOpenChange, tr
     triggerRef: RefObject<HTMLButtonElement | null>;
     children: ReactNode;
 } & Omit<ComponentProps<typeof TfButton>, "onClick" | "onKeyDown" | "ref">): import("react").JSX.Element;
-/** The dropped-open half. Mounted only while open — the parent gates the
- *  render, so unmounting is the close and no state survives a minimize.
- *  The caller's className carries the anchor side and measure (the
- *  history menu hangs `left-2 w-72` under its title; a right-edge
- *  disclosure would pass `right-2`). */
 export declare function HeaderDisclosureMenu({ id, onClose, triggerRef, triggerId, "aria-label": ariaLabel, className, insetFromSurfaceTop, autoFocusFirstButton, children, }: {
     id: string;
     onClose: () => void;
@@ -22,17 +14,7 @@ export declare function HeaderDisclosureMenu({ id, onClose, triggerRef, triggerI
     triggerId?: string;
     "aria-label": string;
     className?: string;
-    /** A host-rendered full-page trigger can live in the host header
-     *  immediately above the assistant. Its menu starts at the surface's
-     *  top inset instead of below the companion's own 56px header. */
     insetFromSurfaceTop?: boolean;
-    /** Default true: the first button is the menu's primary command. A
-     *  tenant whose first button is NOT a safe primary (the connect
-     *  panel's resting state leads with the destructive disconnect, and a
-     *  held Enter on the trigger key-repeats onto whatever gets focus)
-     *  opts out — focus then rests on the trigger, the classic
-     *  disclosure convention, whose own Esc handling still closes. */
     autoFocusFirstButton?: boolean;
     children: ReactNode;
 }): import("react").JSX.Element;
-//# sourceMappingURL=companion-header-disclosure.d.ts.map

package/dist/components/companion-header-disclosure.js

@@ -3,32 +3,10 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { useEffect, useRef, } from "react";
 import { TfButton } from "./primitives/button.js";
 import { cx } from "./primitives/cx.js";
-// The drawer header's disclosure mechanics: a trigger in the header row
-// that drops a small dialog open over the transcript. The history menu
-// wears this today; the mode switcher joins it from the same pair.
-//
-// Trigger and menu are two exports rather than one component because
-// they live on opposite sides of a boundary the DOM enforces: the
-// trigger sits inside the header row, which IS the swipe-dismiss handle
-// (`data-tf-swipe-handle` matches by closest()), and a menu nested in
-// that row would turn every touch-drag over a menu row into a drawer
-// dismissal. The parent owns the open flag and threads it through.
-//
-// The caller's side of the contract: render the menu as a DOM sibling
-// AFTER the panel body, not inside the header row. The package ships no
-// z-index, so among positioned boxes document order is the paint order —
-// a menu mounted before the body would lose to the transcript's own
-// positioned bubbles. This file can't enforce placement; the caller
-// carries the law.
-/** The header-row half: owns the disclosure aria wiring and the
- *  Esc-closes-the-menu-not-the-drawer keydown. Everything else — variant,
- *  className, children — passes through to TfButton. */
 export function HeaderDisclosureTrigger({ menuId, open, onOpenChange, triggerRef, children, ...buttonProps }) {
     return (_jsx(TfButton, { ref: triggerRef, "aria-expanded": open, "aria-controls": menuId, ...buttonProps, onClick: () => {
             onOpenChange(!open);
         }, onKeyDown: (event) => {
-            // Escape with focus on the trigger closes the menu, not the
-            // drawer — stopped so the panel's own Esc-to-close never sees it.
             if (!open || event.key !== "Escape") {
                 return;
             }
@@ -37,19 +15,8 @@ export function HeaderDisclosureTrigger({ menuId, open, onOpenChange, triggerRef
             onOpenChange(false);
         }, children: children }));
 }
-/** The dropped-open half. Mounted only while open — the parent gates the
- *  render, so unmounting is the close and no state survives a minimize.
- *  The caller's className carries the anchor side and measure (the
- *  history menu hangs `left-2 w-72` under its title; a right-edge
- *  disclosure would pass `right-2`). */
 export function HeaderDisclosureMenu({ id, onClose, triggerRef, triggerId, "aria-label": ariaLabel, className, insetFromSurfaceTop = false, autoFocusFirstButton = true, children, }) {
     const menuRef = useRef(null);
-    // Light dismissal: any pointer that goes down outside the menu closes
-    // it. Judged by composedPath(), not contains() — the script-tag
-    // distribution runs in an open shadow root, where document-level
-    // events retarget to the host element and contains() would call every
-    // in-shadow press an outside one. The trigger is excluded so its own
-    // press doesn't close-then-reopen through the click that follows.
     useEffect(() => {
         const menu = menuRef.current;
         if (menu === null) {
@@ -75,19 +42,12 @@ export function HeaderDisclosureMenu({ id, onClose, triggerRef, triggerId, "aria
             doc.removeEventListener("pointerdown", closeUnlessInside);
         };
     }, [onClose, triggerId, triggerRef]);
-    // Opening moves focus into the panel — its first button is the menu's
-    // primary command (unless the tenant opted out above).
     useEffect(() => {
         if (autoFocusFirstButton) {
             menuRef.current?.querySelector("button")?.focus();
         }
     }, [autoFocusFirstButton]);
-    return (
-    // eslint-disable-next-line jsx-a11y/no-noninteractive-element-interactions -- the keydown is the menu's own Esc-to-close; every focusable inside is a real button.
-    _jsx("div", { ref: menuRef, id: id, role: "dialog", "aria-label": ariaLabel, "data-tf-glass": "", "data-tf-disclosure": "", "data-tf-surface-inset": insetFromSurfaceTop ? "" : undefined, className: cx("tf:absolute tf:top-14 tf:flex tf:max-h-96 tf:flex-col tf:overflow-hidden tf:rounded-2xl tf:border", className), onKeyDown: (event) => {
-            // Esc closes the menu and hands focus back to its trigger; the
-            // drawer survives — stopped before the panel's handler minimizes
-            // it too.
+    return (_jsx("div", { ref: menuRef, id: id, role: "dialog", "aria-label": ariaLabel, "data-tf-glass": "", "data-tf-disclosure": "", "data-tf-surface-inset": insetFromSurfaceTop ? "" : undefined, className: cx("tf:absolute tf:top-14 tf:flex tf:max-h-96 tf:flex-col tf:overflow-hidden tf:rounded-2xl tf:border", className), onKeyDown: (event) => {
             if (event.key !== "Escape") {
                 return;
             }
@@ -101,4 +61,3 @@ export function HeaderDisclosureMenu({ id, onClose, triggerRef, triggerId, "aria
             trigger?.focus();
         }, children: children }));
 }
-//# sourceMappingURL=companion-header-disclosure.js.map

package/dist/components/companion-history-menu.d.ts

@@ -1,8 +1,4 @@
 import { type RefObject } from "react";
-/** The title half of the header row. For anonymous visitors the server's
- *  thread list is honestly empty, so there is no history to disclose —
- *  the title stays a static heading with no chevron and no menu (the
- *  page gates its rail the same way). */
 export declare function CompanionHeaderTitle({ menuId, open, onOpenChange, triggerRef, fallbackTitle, }: {
     menuId: string;
     open: boolean;
@@ -10,11 +6,6 @@ export declare function CompanionHeaderTitle({ menuId, open, onOpenChange, trigg
     triggerRef: RefObject<HTMLButtonElement | null>;
     fallbackTitle?: string;
 }): import("react").JSX.Element;
-/** The dropped-open history panel: the shared disclosure menu hung
- *  left-anchored under the title that discloses it, wrapping the shared
- *  thread list. Its first row is "New conversation" — a deliberate twin
- *  of the header's compose button, shared with the page rail and the
- *  phone sheet. */
 export declare function CompanionHistoryMenu({ id, onClose, triggerRef, triggerId, insetFromSurfaceTop, }: {
     id: string;
     onClose: () => void;
@@ -22,4 +13,3 @@ export declare function CompanionHistoryMenu({ id, onClose, triggerRef, triggerI
     triggerId?: string;
     insetFromSurfaceTop?: boolean;
 }): import("react").JSX.Element;
-//# sourceMappingURL=companion-history-menu.d.ts.map

package/dist/components/companion-history-menu.js

@@ -5,45 +5,17 @@ import { HeaderDisclosureMenu, HeaderDisclosureTrigger, } from "./companion-head
 import { ChevronDownIcon } from "./icons.js";
 import { ThreadHistory } from "./thread-list.js";
 import { useAssistantConversation } from "./use-assistant-conversation.js";
-// The drawer header's title-as-disclosure (the Notion register): the
-// active conversation's title with a chevron, and pressing it drops open
-// a small popover of past conversations over the transcript — the same
-// ThreadHistory the page's rail and phone sheet render. One list, three
-// densities, never a fork.
-/** The title half of the header row. For anonymous visitors the server's
- *  thread list is honestly empty, so there is no history to disclose —
- *  the title stays a static heading with no chevron and no menu (the
- *  page gates its rail the same way). */
 export function CompanionHeaderTitle({ menuId, open, onOpenChange, triggerRef, fallbackTitle = "Assistant", }) {
     const core = useAssistantConversation();
-    // `||`, not `??`: a just-created thread can hold an empty title until
-    // the server names it, and while a thread is opening the title lags
-    // one beat behind — "Assistant" covers both gaps. The muted label step
-    // keeps the empty state's centered question the surface's only
-    // headline; weight stated explicitly because the package ships no
-    // preflight, so an unweighted h2 inherits the UA's bold in one host
-    // and the host's own reset in another.
-    // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing -- the empty-string fallback is the point, per above.
     const title = core.conversation?.thread.title || fallbackTitle;
     if (!core.historyExpected) {
         return (_jsx("h2", { className: "tf:min-w-0 tf:flex-1 tf:truncate tf:text-tf-label tf:font-medium tf:text-tf-muted-foreground", children: title }));
     }
     return (_jsx("h2", { className: "tf:flex tf:min-w-0 tf:flex-1 tf:items-center tf:text-tf-label tf:font-medium tf:text-tf-muted-foreground", children: _jsxs(HeaderDisclosureTrigger, { menuId: menuId, open: open, onOpenChange: onOpenChange, triggerRef: triggerRef, variant: "bare", className: "tf:-ml-1.5 tf:min-w-0 tf:px-1.5 tf:py-1 tf:hover:bg-tf-accent tf:hover:text-tf-foreground", children: [_jsx("span", { className: "tf:min-w-0 tf:truncate", children: title }), _jsx(ChevronDownIcon, {})] }) }));
 }
-/** The dropped-open history panel: the shared disclosure menu hung
- *  left-anchored under the title that discloses it, wrapping the shared
- *  thread list. Its first row is "New conversation" — a deliberate twin
- *  of the header's compose button, shared with the page rail and the
- *  phone sheet. */
 export function CompanionHistoryMenu({ id, onClose, triggerRef, triggerId, insetFromSurfaceTop, }) {
     const core = useAssistantConversation();
-    return (_jsx(HeaderDisclosureMenu, { id: id, "aria-label": "Conversation history", onClose: onClose, triggerRef: triggerRef, triggerId: triggerId, insetFromSurfaceTop: insetFromSurfaceTop, 
-        // left-2.5 + the panel hairline puts the menu's edge on the
-        // trigger pill's own left edge; w-80 keeps the menu at least as
-        // wide as the widest title the trigger can show, so a thread name
-        // legible in the header never truncates in the list beneath it
-        // (and still clears the 358px phone card with room to spare).
-        className: "tf:left-2.5 tf:w-80 tf:max-w-[calc(100%-1.25rem)] tf:pt-2", children: _jsx(ThreadHistory, { threads: core.threads, activeThreadId: core.conversation?.thread.id ?? null, safeAreaBottom: false, onSelectThread: (thread) => {
+    return (_jsx(HeaderDisclosureMenu, { id: id, "aria-label": "Conversation history", onClose: onClose, triggerRef: triggerRef, triggerId: triggerId, insetFromSurfaceTop: insetFromSurfaceTop, className: "tf:left-2.5 tf:w-80 tf:max-w-[calc(100%-1.25rem)] tf:pt-2", children: _jsx(ThreadHistory, { threads: core.threads, activeThreadId: core.conversation?.thread.id ?? null, safeAreaBottom: false, onSelectThread: (thread) => {
                 onClose();
                 core.openThread(thread);
             }, onNewConversation: () => {
@@ -51,4 +23,3 @@ export function CompanionHistoryMenu({ id, onClose, triggerRef, triggerId, inset
                 core.startNewConversation();
             } }) }));
 }
-//# sourceMappingURL=companion-history-menu.js.map

package/dist/components/companion-mark-image.d.ts

@@ -1,4 +1,3 @@
 export declare function CompanionMarkImage({ src }: {
     src: string;
 }): import("react").JSX.Element;
-//# sourceMappingURL=companion-mark-image.d.ts.map

package/dist/components/companion-mark-image.js

@@ -2,15 +2,6 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { useState } from "react";
 import { AgentIdentityMark } from "./agent-identity-mark.js";
-// The script-tag route's companion mark: `companion-mark-src` as a
-// decorative image, keeping the stance of the loader it replaced — a
-// broken mark costs the mark, never the page. A 404, a CSP or ad-block
-// refusal, or a URL that is not an image fires the img's error event:
-// one readable console warning per source, then the package flask in
-// its place. The flask is inline SVG and cannot fail to load, so there
-// is no third state. Rendered inside the host-view marker either way;
-// the flask carries no border or box metrics, so the reset it is exempt
-// from there never touches it.
 const warnedSources = new Set();
 export function CompanionMarkImage({ src }) {
     const [failed, setFailed] = useState(false);
@@ -25,4 +16,3 @@ export function CompanionMarkImage({ src }) {
             setFailed(true);
         } }));
 }
-//# sourceMappingURL=companion-mark-image.js.map

package/dist/components/companion-mark.d.ts

@@ -1,2 +1 @@
 export declare function CompanionMark(): import("react").JSX.Element;
-//# sourceMappingURL=companion-mark.d.ts.map

package/dist/components/companion-mark.js

@@ -2,16 +2,7 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { AgentIdentityMark } from "./agent-identity-mark.js";
 import { useAssistantAppearance } from "./appearance-context.js";
-// The one mark every companion stage shows — the corner perch and the
-// drawer's welcome — at one size. Static: the stylesheet sizes the box
-// and sets the node inside to 100% of it (the fill is the package's
-// promise, not the host's). A host's node is host DOM and wears the
-// data-tf-host-view marker so the package reset leaves it alone; the
-// default flask stays package DOM under the reset, unmarked. The null
-// branch is exact on purpose: the provider has already folded the
-// declining values (undefined, null, either boolean) into null.
 export function CompanionMark() {
     const { companionMark } = useAssistantAppearance();
     return (_jsx("span", { "aria-hidden": true, "data-tf-companion-mark": "", children: companionMark === null ? (_jsx(AgentIdentityMark, { register: "primary", size: "fill" })) : (_jsx("span", { "data-tf-host-view": "", className: "tf:contents", children: companionMark })) }));
 }
-//# sourceMappingURL=companion-mark.js.map

package/dist/components/companion-mode-menu.d.ts

@@ -1,17 +1,11 @@
 import { type RefObject } from "react";
 import type { PanelDock } from "../persistence/panel-mode.js";
-/** The header-row half, mounted in the reserved slot between compose and
- *  minimize. The parent hides it below the sidebar's viewport floor by
- *  not rendering it at all. */
 export declare function CompanionModeTrigger({ menuId, open, onOpenChange, triggerRef, }: {
     menuId: string;
     open: boolean;
     onOpenChange: (open: boolean) => void;
     triggerRef: RefObject<HTMLButtonElement | null>;
 }): import("react").JSX.Element;
-/** The dropped-open half: two rows, a check on the active one. Selection
- *  reports up and closes — the parent owns the persisted mode, the menu
- *  never reads storage. */
 export declare function CompanionModeMenu({ id, dock, onSelect, onClose, triggerRef, }: {
     id: string;
     dock: PanelDock;
@@ -19,4 +13,3 @@ export declare function CompanionModeMenu({ id, dock, onSelect, onClose, trigger
     onClose: () => void;
     triggerRef: RefObject<HTMLButtonElement | null>;
 }): import("react").JSX.Element;
-//# sourceMappingURL=companion-mode-menu.d.ts.map

package/dist/components/companion-mode-menu.js

@@ -4,43 +4,16 @@ import {} from "react";
 import { HeaderDisclosureMenu, HeaderDisclosureTrigger, } from "./companion-header-disclosure.js";
 import { CheckIcon, SidebarIcon } from "./icons.js";
 import { TfButton } from "./primitives/button.js";
-// The drawer header's mode switcher: Floating (the corner card, the
-// default) or Sidebar (the flush right-edge dock that pushes the page).
-// The second wearer of the header-disclosure pair — same trigger
-// mechanics, same light dismiss, same Esc discipline as the history
-// menu. Unlike the title, this renders for anonymous visitors too: the
-// mode is chrome, not history, so there is no historyExpected gate. The
-// a11y register also matches the history menu — a small dialog of plain
-// buttons, not menuitemradio rows, which would promise a role="menu"
-// arrow-key contract neither disclosure implements; the active choice
-// rides aria-pressed and a visible check.
-/** The header-row half, mounted in the reserved slot between compose and
- *  minimize. The parent hides it below the sidebar's viewport floor by
- *  not rendering it at all. */
 export function CompanionModeTrigger({ menuId, open, onOpenChange, triggerRef, }) {
     return (_jsx(HeaderDisclosureTrigger, { menuId: menuId, open: open, onOpenChange: onOpenChange, triggerRef: triggerRef, variant: "icon", "aria-label": "Panel position", title: "Panel position", children: _jsx(SidebarIcon, {}) }));
 }
-/** The dropped-open half: two rows, a check on the active one. Selection
- *  reports up and closes — the parent owns the persisted mode, the menu
- *  never reads storage. */
 export function CompanionModeMenu({ id, dock, onSelect, onClose, triggerRef, }) {
-    return (_jsxs(HeaderDisclosureMenu, { id: id, "aria-label": "Panel position", onClose: onClose, triggerRef: triggerRef, 
-        // Right-anchored under the icon cluster it drops from (the history
-        // menu's left-2.5 mirrored); w-52 fits the longer label with the
-        // check's column to spare, and p-1 is the same row inset the
-        // thread list carries.
-        className: "tf:right-2 tf:w-52 tf:p-1", children: [_jsx(ModeRow, { label: "Floating", active: dock === "floating", onSelect: () => {
+    return (_jsxs(HeaderDisclosureMenu, { id: id, "aria-label": "Panel position", onClose: onClose, triggerRef: triggerRef, className: "tf:right-2 tf:w-52 tf:p-1", children: [_jsx(ModeRow, { label: "Floating", active: dock === "floating", onSelect: () => {
                     onSelect("floating");
                 } }), _jsx(ModeRow, { label: "Sidebar", active: dock === "sidebar", onSelect: () => {
                     onSelect("sidebar");
                 } })] }));
 }
 function ModeRow({ label, active, onSelect, }) {
-    return (
-    // The desktop `row` register, not rowTouch: this menu only exists
-    // above the sidebar's viewport floor, so its rows always sit beside
-    // the history menu's desktop-density list — two disclosures off one
-    // header must read at one density.
-    _jsxs(TfButton, { variant: "row", "aria-pressed": active, onClick: onSelect, children: [_jsx("span", { className: "tf:min-w-0 tf:flex-1 tf:truncate", children: label }), active ? _jsx(CheckIcon, {}) : null] }));
+    return (_jsxs(TfButton, { variant: "row", "aria-pressed": active, onClick: onSelect, children: [_jsx("span", { className: "tf:min-w-0 tf:flex-1 tf:truncate", children: label }), active ? _jsx(CheckIcon, {}) : null] }));
 }
-//# sourceMappingURL=companion-mode-menu.js.map

package/dist/components/composer-attachment-chip.d.ts

@@ -5,4 +5,3 @@ export declare function ComposerAttachmentChip({ item, onRemove, }: {
     onRemove: () => void;
 }): import("react").JSX.Element;
 export declare function attachmentAcceptOf(policy: ServedAttachmentPolicy): string | undefined;
-//# sourceMappingURL=composer-attachment-chip.d.ts.map

package/dist/components/composer-attachment-chip.js

@@ -4,21 +4,12 @@ import { attachmentDraftFailed, } from "../core/composer-policy.js";
 import { humanFileSize } from "./human-file-size.js";
 import { CloseIcon, FileIcon } from "./icons.js";
 import { TfButton } from "./primitives/button.js";
-// One drafted attachment in the slab: name and size while it uploads,
-// the failure sentence when it refuses — either way the × removes it.
 export function ComposerAttachmentChip({ item, onRemove, }) {
     const failed = attachmentDraftFailed(item);
     return (_jsxs("span", { className: "tf:inline-flex tf:max-w-full tf:items-center tf:gap-1.5 tf:rounded-lg " +
             "tf:bg-tf-background tf:py-0.5 tf:ps-2 tf:pe-0.5 tf:text-xs tf:ring-1 tf:ring-tf-border tf:ring-inset " +
-            (failed ? "tf:text-tf-destructive" : "tf:text-tf-foreground"), title: failed ? item.error : item.filename, children: [_jsx("span", { className: failed ? "tf:text-tf-destructive" : "tf:text-tf-muted-foreground", children: _jsx(FileIcon, {}) }), _jsx("span", { className: "tf:min-w-0 tf:truncate", children: item.filename }), _jsx("span", { className: "tf:shrink-0 tf:text-tf-muted-foreground", children: item.status === "uploading" ? (
-                // Live work on a settled chip: the pulse is the sanctioned
-                // "still going" idiom — a static label reads as hung over a
-                // minutes-long upload.
-                _jsx("span", { className: "tf:animate-tf-pulse tf:motion-reduce:animate-none", children: "uploading\u2026" })) : failed ? ((item.error ?? "failed")) : (humanFileSize(item.byteSize)) }), _jsx(TfButton, { variant: "icon", onClick: onRemove, "aria-label": `Remove ${item.filename}`, children: _jsx(CloseIcon, {}) })] }));
+            (failed ? "tf:text-tf-destructive" : "tf:text-tf-foreground"), title: failed ? item.error : item.filename, children: [_jsx("span", { className: failed ? "tf:text-tf-destructive" : "tf:text-tf-muted-foreground", children: _jsx(FileIcon, {}) }), _jsx("span", { className: "tf:min-w-0 tf:truncate", children: item.filename }), _jsx("span", { className: "tf:shrink-0 tf:text-tf-muted-foreground", children: item.status === "uploading" ? (_jsx("span", { className: "tf:animate-tf-pulse tf:motion-reduce:animate-none", children: "uploading\u2026" })) : failed ? ((item.error ?? "failed")) : (humanFileSize(item.byteSize)) }), _jsx(TfButton, { variant: "icon", onClick: onRemove, "aria-label": `Remove ${item.filename}`, children: _jsx(CloseIcon, {}) })] }));
 }
-// The picker's accept list, derived from the released kinds. A released
-// generic-file kind means anything goes — no accept at all; otherwise
-// each kind contributes its family.
 export function attachmentAcceptOf(policy) {
     const kinds = policy.kinds;
     if (kinds.includes("file")) {
@@ -39,4 +30,3 @@ export function attachmentAcceptOf(policy) {
     }
     return families.join(",");
 }
-//# sourceMappingURL=composer-attachment-chip.js.map

package/dist/components/composer-banner.d.ts

@@ -0,0 +1,4 @@
+import type { ConversationGate } from "../core/connect-gate.js";
+export declare function ComposerBanner({ gate }: {
+    gate: ConversationGate;
+}): import("react").JSX.Element | null;

package/dist/components/composer-banner.js

@@ -0,0 +1,17 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { ConversationGateCard } from "./conversation-gate-card.js";
+import { SubscriptionPlanNotice } from "./subscription-plan-notice.js";
+import { useOptionalAssistantSession } from "./teaflask-assistant-provider.js";
+export function ComposerBanner({ gate }) {
+    const session = useOptionalAssistantSession();
+    if (gate.kind === "connect" ||
+        gate.kind === "wait" ||
+        gate.kind === "verifying") {
+        return _jsx(ConversationGateCard, { gate: gate });
+    }
+    if (gate.kind === "none" && session !== null) {
+        return _jsx(SubscriptionPlanNotice, {});
+    }
+    return null;
+}

package/dist/components/composer.d.ts

@@ -1,20 +1,4 @@
-/**
- * The message composer. Sending is the contract's message POST, wired in
- * by context (never the stream — the watch-only stream cannot create a
- * turn). The maxLength mirrors the send surface's bound so the limit is
- * felt while typing, not as a 422 after submitting. Attachments ride the
- * served policy: no policy, no paperclip.
- *
- * `surface` is the caret-return handoff's identity: several
- * surfaces render this composer over ONE store, and a reconnect-nonce
- * bump remounts all of them in one commit — the store's focus record
- * and the owed caret return are stamped with the owning surface so only
- * the matching fresh instance consumes the return. PREMISE: surface
- * names are unique per mounted view — the transcript lease already
- * keys its holder list on the same strings.
- */
 export declare function Composer({ compact, surface, }: {
     compact?: boolean;
     surface?: string;
 }): import("react").JSX.Element;
-//# sourceMappingURL=composer.d.ts.map