@teaflask/assistant 0.6.0 → 0.7.0

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

@@ -47,7 +47,7 @@ export function HeaderDisclosureMenu({ id, onClose, triggerRef, triggerId, "aria
             menuRef.current?.querySelector("button")?.focus();
         }
     }, [autoFocusFirstButton]);
-    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) => {
+    return (_jsx("div", { ref: menuRef, id: id, role: "dialog", "aria-label": ariaLabel, "data-tf-glass": "", "data-tf-popover": "", "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;
             }

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

@@ -11,7 +11,7 @@ export function CompanionHeaderTitle({ menuId, open, onOpenChange, triggerRef, f
     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, {})] }) }));
+    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-accent-foreground", children: [_jsx("span", { className: "tf:min-w-0 tf:truncate", children: title }), _jsx(ChevronDownIcon, {})] }) }));
 }
 export function CompanionHistoryMenu({ id, onClose, triggerRef, triggerId, insetFromSurfaceTop, }) {
     const core = useAssistantConversation();

package/dist/components/composer.js

@@ -1,8 +1,7 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { useEffect, useLayoutEffect, useRef, useState, } from "react";
-import { ASSISTANT_MAX_ATTACHMENTS, ASSISTANT_MESSAGE_MAX_CHARS, } from "../contract/threads.js";
-import { humanFileSize } from "./human-file-size.js";
+import { ASSISTANT_MESSAGE_MAX_CHARS, } from "../contract/threads.js";
 import { attachmentAcceptOf, ComposerAttachmentChip, } from "./composer-attachment-chip.js";
 import { ComposerBanner } from "./composer-banner.js";
 import { useConversation } from "./conversation-context.js";
@@ -13,14 +12,15 @@ import { TfTextarea } from "./primitives/textarea.js";
 import { ModelPickerShelf } from "./model-picker-chip.js";
 import { useOptionalAssistantSession } from "./teaflask-assistant-provider.js";
 import { NO_GATE } from "../core/connect-gate.js";
-import { attachmentDraftFailed, capSlotsSpentBy, CHARACTER_COUNT_VISIBLE_FROM, composerKeyHandlersOf, mintAttachmentDraftId, pickCapOf, } from "../core/composer-policy.js";
+import { attachmentRoomOf } from "../core/composer-attachments.js";
+import { attachmentDraftFailed, capSlotsSpentBy, CHARACTER_COUNT_VISIBLE_FROM, composerKeyHandlersOf, } from "../core/composer-policy.js";
 import { ObservableCell } from "../core/observable-cell.js";
 import { useCell } from "./use-store-cell.js";
 const NO_POLICY = new ObservableCell(null);
 const NO_GATE_CELL = new ObservableCell(NO_GATE);
 const COMPOSER_MAX_HEIGHT_PX = 200;
 export function Composer({ compact = false, surface = "page", }) {
-    const { busy, pendingSend, sendMessage, composerRefocusPending, markComposerRefocusHandled, stopping, stopTurn, composerInput, setDraft, setAttachments, noteComposerFocus, takeComposerCaretReturn, } = useConversation();
+    const { busy, pendingSend, sendMessage, composerRefocusPending, markComposerRefocusHandled, stopping, stopTurn, composerInput, setDraft, setAttachments, addFiles, noteComposerFocus, takeComposerCaretReturn, } = useConversation();
     const { draft, attachments } = useCell(composerInput);
     const session = useOptionalAssistantSession();
     const policy = useCell(session?.attachmentPolicy ?? NO_POLICY);
@@ -37,7 +37,7 @@ export function Composer({ compact = false, surface = "page", }) {
     const attach = useComposerAttachments({
         session,
         policy,
-        attachments,
+        addFiles,
         setAttachments,
     });
     const { textareaRef, onTextareaFocus, onTextareaBlur } = useComposerFocus({
@@ -96,74 +96,20 @@ function useComposerSend({ busy, draft, attachments, composerInput, sendMessage,
     }
     return { sending, sendDisabled, submitDraft };
 }
-function useComposerAttachments({ session, policy, attachments, setAttachments, }) {
+function useComposerAttachments({ session, policy, addFiles, setAttachments, }) {
     useEffect(() => {
         session?.ensureAssistantConfig();
     }, [session]);
-    function addFiles(files) {
-        if (files === null || policy === null || session === null) {
-            return;
-        }
-        const { store } = session;
-        const room = Math.min(policy.max_per_message, ASSISTANT_MAX_ATTACHMENTS);
-        let taken = capSlotsSpentBy(attachments);
-        for (const file of Array.from(files)) {
-            const localId = mintAttachmentDraftId();
-            const entry = {
-                localId,
-                filename: file.name !== "" ? file.name : "attachment",
-                byteSize: file.size,
-                status: "uploading",
-            };
-            if (taken >= room) {
-                setAttachments((current) => [
-                    ...current,
-                    {
-                        ...entry,
-                        status: "failed",
-                        error: `Too many files — the limit is ${String(room)} per message.`,
-                    },
-                ]);
-                continue;
-            }
-            const cap = pickCapOf(file, policy.max_bytes_by_kind);
-            if (file.size > cap.bytes) {
-                setAttachments((current) => [
-                    ...current,
-                    {
-                        ...entry,
-                        status: "failed",
-                        error: `Too large — the limit for ${cap.label} is ${humanFileSize(cap.bytes)}.`,
-                    },
-                ]);
-                continue;
-            }
-            taken += 1;
-            setAttachments((current) => [...current, entry]);
-            store.uploadAttachment(file).then((settled) => {
-                setAttachments((current) => current.map((item) => item.localId === localId
-                    ? { ...item, status: "ready", attachment: settled }
-                    : item));
-            }, (error) => {
-                setAttachments((current) => current.map((item) => item.localId === localId
-                    ? {
-                        ...item,
-                        status: "failed",
-                        error: error instanceof Error
-                            ? error.message
-                            : "The upload failed.",
-                    }
-                    : item));
-            });
+    function pickFiles(files) {
+        if (files !== null) {
+            void addFiles(files);
         }
     }
     function removeAttachment(localId) {
         setAttachments((current) => current.filter((item) => item.localId !== localId));
     }
-    const attachmentRoom = policy === null
-        ? 0
-        : Math.min(policy.max_per_message, ASSISTANT_MAX_ATTACHMENTS);
-    return { attachmentRoom, addFiles, removeAttachment };
+    const attachmentRoom = policy === null ? 0 : attachmentRoomOf(policy);
+    return { attachmentRoom, addFiles: pickFiles, removeAttachment };
 }
 function useComposerFocus({ surface, draft, busy, composerRefocusPending, markComposerRefocusHandled, noteComposerFocus, takeComposerCaretReturn, }) {
     const textareaRef = useRef(null);

package/dist/components/conversation-context.d.ts

@@ -1,4 +1,10 @@
 import type { ComposerContract } from "../core/conversation-store.js";
 export type { ComposerContract };
 export declare const ConversationContext: import("react").Context<ComposerContract | null>;
+/**
+ * Returns the live message-box state and controls for the open conversation
+ * (busy and stopping flags, the draft, `sendMessage`, `stopTurn`), for building
+ * your own composer or send buttons. It must be called inside the provider
+ * (from either entry point) and throws otherwise.
+ */
 export declare function useConversation(): ComposerContract;

package/dist/components/conversation-gate-card.js

@@ -34,7 +34,7 @@ function ConnectBannerRow({ status, gate, refresh, }) {
         session.notePlanSignedIn(status.provider);
     });
     if (connect.flow.kind !== "idle") {
-        return (_jsx(ConnectFlow, { name: name, flow: connect.flow, errorSentence: connect.errorSentence, onBegin: connect.begin, onCancel: connect.cancel, onTabOpened: connect.noteTabOpened }));
+        return (_jsx(ConnectFlow, { name: name, flow: connect.flow, errorSentence: connect.errorSentence, onBegin: connect.begin, onCancel: connect.cancel }));
     }
     const taster = gate.reason === "taster_exhausted";
     return (_jsxs(_Fragment, { children: [_jsxs("div", { className: "tf:flex tf:flex-wrap tf:items-center tf:gap-x-3 tf:gap-y-2", children: [_jsxs("p", { className: "tf:m-0 tf:flex tf:min-w-56 tf:flex-1 tf:items-center tf:gap-2 tf:text-tf-label tf:text-tf-foreground", children: [_jsx(OpenAiMarkIcon, {}), taster

package/dist/components/conversation-view.d.ts

@@ -1,10 +1,21 @@
 import type { ReactNode } from "react";
 import type { AssistantConversation } from "./use-assistant-conversation.js";
+/**
+ * The icon for an opening prompt. `"ask"` shows a magnifying glass, `"review"`
+ * a flag, `"write"` a pencil and `"learn"` a book.
+ */
 export type AssistantSuggestionKind = "ask" | "review" | "write" | "learn";
+/** An opening prompt, with the icon shown beside it. */
 export interface AssistantSuggestion {
+    /** The text shown and, when clicked, sent as the user's message. */
     prompt: string;
+    /** Which icon the prompt shows, and the default is `"ask"`. */
     kind?: AssistantSuggestionKind;
 }
+/**
+ * An opening prompt, given as plain text (shown with the `"ask"` icon) or as an
+ * object with a `kind`.
+ */
 export type AssistantSuggestionInput = string | AssistantSuggestion;
 export declare function ConversationView({ core, surface, suggestions, welcomeTitle, welcomeMark, }: {
     core: AssistantConversation;

package/dist/components/elicitation-context.d.ts

@@ -1,14 +1,53 @@
 import type { ElicitationCardModel, QuestionSetCardModel } from "../core/elicitation-cards.js";
 import { QuestionDraftStore } from "../core/question-drafts.js";
+/**
+ * The question sets to show, how to answer or dismiss them, and their unsent
+ * answers, as returned by useElicitations().
+ */
 export interface ElicitationSurface {
+    /**
+     * Question sets the agent has asked in the open conversation. Sets already
+     * answered or no longer answerable can stay in the list for a while, so
+     * render by each card's status.
+     */
     cards: readonly ElicitationCardModel[];
+    /**
+     * Sends answers to a whole question set in one request, exactly one { id,
+     * text } per question, each text at most 1,900 characters. It does not
+     * reject: on a server error or while the conversation is disconnected the
+     * card's errorSentence explains it, the card stays answerable and the draft
+     * is kept; on success the set's draft is cleared; a set that was already
+     * answered elsewhere or has expired turns stale instead (it can no longer
+     * be answered), and its draft goes with it. Repeat submits while one is in
+     * flight are ignored.
+     */
     submitQuestionAnswers: (card: QuestionSetCardModel, answers: readonly {
         id: string;
         text: string;
     }[]) => Promise<void>;
+    /**
+     * Dismisses a whole question set without answering: the agent is told the
+     * visitor declined and carries on without asking the same questions again.
+     * Like submitQuestionAnswers it does not reject. While the conversation is
+     * disconnected, or on a server error, nothing is dismissed and the card's
+     * errorSentence says so. On success the set's draft is cleared; a set
+     * already answered elsewhere or expired turns stale instead, and its draft
+     * goes with it. Repeat requests while one is in flight are ignored.
+     */
     cancelQuestionSet: (card: QuestionSetCardModel) => Promise<void>;
+    /**
+     * The visitor's unsent answers, kept outside your components so remounts
+     * and reconnects don't lose them. In memory only, so a page reload discards
+     * them.
+     */
     drafts: QuestionDraftStore;
 }
 export declare const ElicitationsContext: import("react").Context<ElicitationSurface>;
+/**
+ * Returns the questions the agent is asking the visitor, the functions that
+ * answer or dismiss them, and the store of unsent answers. Live inside
+ * <TeaflaskAssistantProvider>; outside it the list is empty and submitting or
+ * cancelling rejects with an error.
+ */
 export declare function useElicitations(): ElicitationSurface;
 export declare function anchoredElicitationsFor(cards: readonly ElicitationCardModel[], toolCallId: string): ElicitationCardModel[];

package/dist/components/model-picker-chip.js

@@ -56,7 +56,9 @@ function MountedModelPickerShelf() {
     }
     return (_jsxs("div", { className: "tf:relative tf:mt-1.5 tf:flex tf:items-center tf:justify-end tf:gap-2 tf:px-1", children: [ownsAccountChip ? (_jsx(ProviderChip, { statuses: connectable, open: openChip === "account", onOpenChange: (next) => {
                     setOpenChip(next ? "account" : null);
-                }, fundingNote: "Models your plan serves run on it; other picks run on this site's own funding." })) : null, _jsx(ModelPickerChip, { menu: menu, open: openChip === "picker", onOpenChange: (next) => {
+                }, fundingNote: connectable.some((status) => status.offered)
+                    ? "Models your plan serves run on it; other picks run on this site's own funding."
+                    : undefined })) : null, _jsx(ModelPickerChip, { menu: menu, open: openChip === "picker", onOpenChange: (next) => {
                     setOpenChip(next ? "picker" : null);
                 } })] }));
 }
@@ -64,7 +66,7 @@ function ModelPickerChip({ menu, open, onOpenChange, }) {
     const { modelPick, setModelPick } = useConversation();
     const { panel, setPanel, showPanel, triggerRef, menuRef, rootPanelRef, modelPanelRef, effortPanelRef, } = useModelPickerPanels({ open, onOpenChange });
     const { currentModelId, renderedLadder, currentEffort, currentName } = pickerSelectionOf(menu, modelPick);
-    return (_jsxs(_Fragment, { children: [_jsx(ModelPickerTrigger, { triggerRef: triggerRef, open: open, onOpenChange: onOpenChange, setPanel: setPanel, currentName: currentName, currentEffort: currentEffort }), open ? (_jsxs("div", { ref: menuRef, id: "tf-model-picker-menu", role: "dialog", "aria-label": "Choose model and effort", "data-tf-glass": "", className: "tf:absolute tf:right-0 tf:bottom-full tf:mb-2 tf:flex tf:max-h-[min(32rem,calc(100vh-6rem))] tf:w-80 tf:max-w-full tf:flex-col tf:overflow-y-auto tf:rounded-2xl tf:border tf:p-2", onKeyDown: (event) => {
+    return (_jsxs(_Fragment, { children: [_jsx(ModelPickerTrigger, { triggerRef: triggerRef, open: open, onOpenChange: onOpenChange, setPanel: setPanel, currentName: currentName, currentEffort: currentEffort }), open ? (_jsxs("div", { ref: menuRef, id: "tf-model-picker-menu", role: "dialog", "aria-label": "Choose model and effort", "data-tf-glass": "", "data-tf-popover": "", className: "tf:absolute tf:right-0 tf:bottom-full tf:mb-2 tf:flex tf:max-h-[min(32rem,calc(100vh-6rem))] tf:w-80 tf:max-w-full tf:flex-col tf:overflow-y-auto tf:rounded-2xl tf:border tf:p-2", onKeyDown: (event) => {
                     if (event.key !== "Escape") {
                         return;
                     }

package/dist/components/primitives/button.js

@@ -7,7 +7,13 @@ const VARIANT_CLASSES = {
         "tf:bg-tf-primary tf:text-tf-primary-foreground tf:shadow-tf-control " +
         "tf:hover:opacity-90 tf:disabled:opacity-50",
     ghost: "tf:justify-center tf:rounded-tf tf:border-0 tf:px-3 tf:py-1.5 tf:text-tf-label tf:font-medium " +
-        "tf:bg-tf-transparent tf:text-tf-foreground tf:hover:bg-tf-accent tf:disabled:opacity-50",
+        "tf:bg-tf-transparent tf:text-tf-foreground tf:hover:bg-tf-accent " +
+        "tf:hover:text-tf-accent-foreground tf:disabled:opacity-50",
+    secondary: "tf:relative tf:isolate tf:justify-center tf:rounded-tf tf:border-0 tf:px-3 tf:py-1.5 " +
+        "tf:text-tf-label tf:font-medium tf:bg-tf-secondary tf:text-tf-secondary-foreground " +
+        "tf:after:pointer-events-none tf:after:absolute tf:after:inset-0 tf:after:-z-10 " +
+        "tf:after:rounded-tf tf:after:bg-tf-accent tf:after:opacity-0 tf:after:transition-opacity " +
+        "tf:hover:after:opacity-100 tf:disabled:opacity-50",
     send: "tf:size-8 tf:shrink-0 tf:justify-center tf:rounded-full tf:border-0 " +
         "tf:bg-tf-primary tf:text-tf-primary-foreground tf:shadow-tf-control " +
         "tf:hover:opacity-90 tf:disabled:bg-tf-muted tf:disabled:text-tf-muted-foreground " +
@@ -16,28 +22,28 @@ const VARIANT_CLASSES = {
         "tf:bg-tf-primary tf:text-tf-primary-foreground tf:shadow-tf-control " +
         "tf:hover:opacity-90 tf:aria-disabled:cursor-not-allowed tf:aria-disabled:opacity-70",
     icon: "tf:size-7 tf:justify-center tf:rounded-tf tf:border-0 tf:bg-tf-transparent tf:text-tf-muted-foreground " +
-        "tf:hover:bg-tf-accent tf:hover:text-tf-foreground tf:disabled:opacity-50",
+        "tf:hover:bg-tf-accent tf:hover:text-tf-accent-foreground tf:disabled:opacity-50",
     iconFloating: "tf:justify-center tf:rounded-full tf:border tf:bg-tf-background " +
         "tf:text-tf-muted-foreground tf:shadow-tf-control " +
-        "tf:hover:bg-tf-accent tf:hover:text-tf-foreground tf:disabled:opacity-50",
+        "tf:hover:bg-tf-accent tf:hover:text-tf-accent-foreground tf:disabled:opacity-50",
     row: "tf:h-8 tf:w-full tf:justify-start tf:rounded-tf tf:border-0 tf:px-2.5 tf:text-left tf:text-sm tf:font-medium " +
         "tf:bg-tf-transparent tf:text-tf-muted-foreground tf:hover:bg-tf-accent " +
-        "tf:hover:text-tf-foreground tf:aria-[current=true]:bg-tf-accent " +
-        "tf:aria-[current=true]:text-tf-foreground tf:disabled:opacity-50",
+        "tf:hover:text-tf-accent-foreground tf:aria-[current=true]:bg-tf-accent " +
+        "tf:aria-[current=true]:text-tf-accent-foreground tf:disabled:opacity-50",
     rowAction: "tf:h-9 tf:w-full tf:justify-start tf:gap-2 tf:rounded-tf tf:border-0 tf:px-2.5 tf:text-left tf:text-sm " +
         "tf:font-medium tf:bg-tf-transparent tf:text-tf-foreground tf:hover:bg-tf-accent " +
-        "tf:disabled:opacity-50",
+        "tf:hover:text-tf-accent-foreground tf:disabled:opacity-50",
     rowTouch: "tf:h-11 tf:w-full tf:justify-start tf:gap-2 tf:rounded-tf tf:border-0 tf:px-3 tf:text-left " +
         "tf:text-tf-body tf:font-medium tf:bg-tf-transparent tf:text-tf-muted-foreground " +
-        "tf:hover:bg-tf-accent tf:hover:text-tf-foreground " +
-        "tf:aria-[current=true]:bg-tf-accent tf:aria-[current=true]:text-tf-foreground " +
+        "tf:hover:bg-tf-accent tf:hover:text-tf-accent-foreground " +
+        "tf:aria-[current=true]:bg-tf-accent tf:aria-[current=true]:text-tf-accent-foreground " +
         "tf:disabled:opacity-50",
     rowActionTouch: "tf:h-11 tf:w-full tf:justify-start tf:gap-2 tf:rounded-tf tf:border-0 tf:px-3 tf:text-left " +
         "tf:text-tf-body tf:font-medium tf:bg-tf-transparent tf:text-tf-foreground " +
-        "tf:hover:bg-tf-accent tf:disabled:opacity-50",
+        "tf:hover:bg-tf-accent tf:hover:text-tf-accent-foreground tf:disabled:opacity-50",
     prompt: "tf:min-h-11 tf:w-full tf:justify-start tf:gap-2.5 tf:rounded-tf tf:border-0 tf:px-4 tf:py-2 " +
         "tf:text-left tf:text-tf-label tf:bg-tf-transparent tf:text-tf-foreground " +
-        "tf:hover:bg-tf-accent tf:disabled:opacity-50 " +
+        "tf:hover:bg-tf-accent tf:hover:text-tf-accent-foreground tf:disabled:opacity-50 " +
         "tf:[&_[data-tf-prompt-mark]]:text-tf-muted-foreground " +
         "tf:[&_[data-tf-prompt-go]]:opacity-0 tf:[&_[data-tf-prompt-go]]:transition-opacity " +
         "tf:hover:[&_[data-tf-prompt-go]]:opacity-100 " +
@@ -46,21 +52,23 @@ const VARIANT_CLASSES = {
     bare: "tf:rounded-tf tf:border-0 tf:bg-tf-transparent tf:p-0 tf:text-inherit tf:disabled:opacity-50",
     chip: "tf:rounded-full tf:border-0 tf:px-2 tf:py-1 tf:text-tf-label tf:font-medium " +
         "tf:bg-tf-transparent tf:text-tf-foreground tf:hover:bg-tf-accent " +
-        "tf:disabled:opacity-50",
+        "tf:hover:text-tf-accent-foreground tf:disabled:opacity-50",
     chipQuiet: "tf:rounded-full tf:border-0 tf:px-2 tf:py-1 tf:text-tf-label tf:font-medium " +
         "tf:bg-tf-transparent tf:text-tf-muted-foreground tf:hover:bg-tf-accent " +
-        "tf:hover:text-tf-foreground tf:disabled:opacity-50",
+        "tf:hover:text-tf-accent-foreground tf:disabled:opacity-50",
     outline: "tf:justify-center tf:rounded-full tf:border tf:px-2.5 tf:py-[5px] tf:text-tf-label tf:font-medium " +
         "tf:bg-tf-background tf:text-tf-foreground tf:shadow-tf-control " +
-        "tf:hover:bg-tf-accent tf:disabled:opacity-50",
+        "tf:hover:bg-tf-accent tf:hover:text-tf-accent-foreground tf:disabled:opacity-50",
+    glassChip: "tf:justify-center tf:rounded-full tf:border tf:px-2.5 tf:py-[5px] tf:text-tf-label " +
+        "tf:font-normal tf:disabled:opacity-50",
     answerRow: "tf:min-h-11 tf:w-full tf:items-start tf:justify-start tf:gap-3 tf:rounded-tf tf:border-0 " +
         "tf:bg-tf-transparent tf:px-3 tf:py-2.5 tf:text-left tf:text-tf-label tf:text-tf-foreground " +
-        "tf:wrap-anywhere tf:hover:bg-tf-accent tf:disabled:opacity-50 " +
-        "tf:aria-checked:bg-tf-emphasis",
+        "tf:wrap-anywhere tf:hover:bg-tf-accent tf:hover:text-tf-accent-foreground " +
+        "tf:disabled:opacity-50 tf:aria-checked:bg-tf-emphasis tf:aria-checked:text-tf-foreground",
 };
 export const TfButton = forwardRef(function TfButton({ variant = "primary", className, type, ...props }, ref) {
-    return (_jsx("button", { ref: ref, type: type ?? "button", className: cx("tf:appearance-none", "tf:inline-flex tf:items-center tf:gap-1.5 tf:transition-colors", "tf:focus-visible:outline-2 tf:focus-visible:outline-offset-2 tf:focus-visible:outline-tf-ring", "tf:disabled:cursor-not-allowed", VARIANT_CLASSES[variant], className), ...props }));
+    return (_jsx("button", { ref: ref, type: type ?? "button", ...(variant === "secondary" ? { "data-tf-secondary": "" } : {}), className: cx("tf:appearance-none", "tf:inline-flex tf:items-center tf:gap-1.5 tf:transition-colors", "tf:focus-visible:outline-2 tf:focus-visible:outline-offset-2 tf:focus-visible:outline-tf-ring", "tf:disabled:cursor-not-allowed", VARIANT_CLASSES[variant], className), ...props }));
 });
 export function TfLinkButton({ variant = "primary", className, children, ...props }) {
-    return (_jsx("a", { className: cx("tf:appearance-none tf:no-underline", "tf:inline-flex tf:items-center tf:gap-1.5 tf:transition-colors", "tf:focus-visible:outline-2 tf:focus-visible:outline-offset-2 tf:focus-visible:outline-tf-ring", VARIANT_CLASSES[variant], className), ...props, children: children }));
+    return (_jsx("a", { ...(variant === "secondary" ? { "data-tf-secondary": "" } : {}), className: cx("tf:appearance-none tf:no-underline", "tf:inline-flex tf:items-center tf:gap-1.5 tf:transition-colors", "tf:focus-visible:outline-2 tf:focus-visible:outline-offset-2 tf:focus-visible:outline-tf-ring", VARIANT_CLASSES[variant], className), ...props, children: children }));
 }

package/dist/components/primitives/floating-panel.js

@@ -42,7 +42,7 @@ export function TfFloatingPanel({ open, onOpenChange, corner = "bottom-right", d
         handleSelector: "[data-tf-swipe-handle]",
     });
     useDockReflow(panelRef, dock);
-    return (_jsx("div", { ref: panelRef, popover: "manual", role: "dialog", "data-tf-assistant": "", "data-tf-floating-panel": corner, "data-tf-panel-dock": dock, "data-tf-glass": dock === "floating" ? "" : undefined, onToggle: parkOnForcedHide, onKeyDown: closeFromEscape, onPointerDown: swipe.onPointerDown, onPointerMove: swipe.onPointerMove, onPointerUp: swipe.onPointerUp, onPointerCancel: swipe.onPointerCancel, onClickCapture: swipe.onClickCapture, className: cx("tf:m-0 tf:hidden tf:p-0 tf:open:flex!", "tf:flex-col tf:overflow-hidden tf:text-tf-foreground", dock === "sidebar"
+    return (_jsx("div", { ref: panelRef, popover: "manual", role: "dialog", "data-tf-assistant": "", "data-tf-floating-panel": corner, "data-tf-panel-dock": dock, "data-tf-glass": dock === "floating" ? "" : undefined, onToggle: parkOnForcedHide, onKeyDown: closeFromEscape, onPointerDown: swipe.onPointerDown, onPointerMove: swipe.onPointerMove, onPointerUp: swipe.onPointerUp, onPointerCancel: swipe.onPointerCancel, onClickCapture: swipe.onClickCapture, className: cx("tf:m-0 tf:hidden tf:p-0 tf:open:flex!", "tf:flex-col tf:overflow-hidden", dock === "sidebar"
             ?
                 "tf:inset-y-0 tf:right-0 tf:left-auto tf:h-dvh tf:w-104 tf:max-w-[calc(100vw-2rem)] tf:rounded-none tf:bg-tf-background tf:shadow-none"
             : cx("tf:inset-auto tf:bottom-4 tf:w-[clamp(24rem,44vw,46rem)] tf:max-w-[calc(100vw-2rem)]", "tf:h-[min(68dvh,52rem,calc(100dvh-6rem))]", "tf:rounded-3xl tf:border", corner === "bottom-left" ? "tf:left-4" : "tf:right-4"), className), ...props, children: children }));

package/dist/components/provider-chip.js

@@ -85,7 +85,7 @@ export function ProviderChip({ statuses, open, onOpenChange, fundingNote, }) {
                     event.preventDefault();
                     event.stopPropagation();
                     onOpenChange(false);
-                }, children: [_jsx(OpenAiMarkIcon, {}), _jsx("span", { className: "tf:whitespace-nowrap", children: headline.label }), _jsx(ChevronDownIcon, {})] }), open ? (_jsxs("div", { ref: menuRef, id: "tf-provider-chip-menu", role: "dialog", "aria-label": headline.accessibleName, "data-tf-glass": "", className: "tf:absolute tf:right-0 tf:bottom-full tf:mb-2 tf:flex tf:w-80 tf:max-w-[calc(100vw-2rem)] tf:flex-col tf:gap-3 tf:overflow-y-auto tf:rounded-2xl tf:border tf:p-3", onKeyDown: (event) => {
+                }, children: [_jsx(OpenAiMarkIcon, {}), _jsx("span", { className: "tf:whitespace-nowrap", children: headline.label }), _jsx(ChevronDownIcon, {})] }), open ? (_jsxs("div", { ref: menuRef, id: "tf-provider-chip-menu", role: "dialog", "aria-label": headline.accessibleName, "data-tf-glass": "", "data-tf-popover": "", className: "tf:absolute tf:right-0 tf:bottom-full tf:mb-2 tf:flex tf:w-80 tf:max-w-[calc(100vw-2rem)] tf:flex-col tf:gap-3 tf:overflow-y-auto tf:rounded-2xl tf:border tf:p-3", onKeyDown: (event) => {
                     if (event.key !== "Escape") {
                         return;
                     }
@@ -112,6 +112,13 @@ function _chipHeadlineOf(statuses) {
             connected: false,
         };
     }
+    if (!holding.offered) {
+        return {
+            label: `${name} · not in use`,
+            accessibleName: `${name} plan — not in use`,
+            connected: true,
+        };
+    }
     if (holding.state === "verifying") {
         return {
             label: `${name} · verifying…`,

package/dist/components/question-panel-footer.js

@@ -8,7 +8,7 @@ export function QuestionPanelFooter({ card, cursor, gateReason, disabled, submit
     const total = card.questions.length;
     const isLast = cursor === total - 1;
     const { confirming, cancelRef, keepEditingRef, requestCancel, keepEditing, discard, } = useCancelConfirm(card);
-    return (_jsx("div", { "data-tf-question-footer": "", className: "tf:mt-3 tf:flex tf:flex-wrap tf:items-center tf:justify-end tf:gap-2", children: card.status === "submitting" ? (_jsx("p", { className: "tf:flex tf:items-center tf:gap-2 tf:text-tf-label tf:text-tf-muted-foreground", children: _jsx(Spinner, { label: "Sending\u2026" }) })) : confirming ? (_jsxs(Fragment, { children: [_jsx("span", { className: "tf:text-tf-label tf:text-tf-muted-foreground", children: "Discard answers?" }), _jsx(TfButton, { ref: keepEditingRef, variant: "ghost", onClick: keepEditing, children: "Keep editing" }), _jsx(TfButton, { variant: "outline", onClick: discard, children: "Discard" })] }, "confirm")) : (_jsxs(Fragment, { children: [gateReason !== null ? (_jsx("span", { "data-tf-question-gate": "", className: "tf:me-auto tf:text-tf-label tf:text-tf-muted-foreground", children: gateReason })) : null, _jsx(TfButton, { ref: cancelRef, variant: "ghost", disabled: disabled, onClick: requestCancel, children: "Cancel" }), _jsx(TfButton, { variant: "primary", disabled: disabled || submitGated, onClick: onProceed, children: isLast
+    return (_jsx("div", { "data-tf-question-footer": "", className: "tf:mt-3 tf:flex tf:flex-wrap tf:items-center tf:justify-end tf:gap-2", children: card.status === "submitting" ? (_jsx("p", { className: "tf:flex tf:items-center tf:gap-2 tf:text-tf-label tf:text-tf-muted-foreground", children: _jsx(Spinner, { label: "Sending\u2026" }) })) : confirming ? (_jsxs(Fragment, { children: [_jsx("span", { className: "tf:text-tf-label tf:text-tf-muted-foreground", children: "Discard answers?" }), _jsx(TfButton, { ref: keepEditingRef, variant: "secondary", onClick: keepEditing, children: "Keep editing" }), _jsx(TfButton, { variant: "outline", onClick: discard, children: "Discard" })] }, "confirm")) : (_jsxs(Fragment, { children: [gateReason !== null ? (_jsx("span", { "data-tf-question-gate": "", className: "tf:me-auto tf:text-tf-label tf:text-tf-muted-foreground", children: gateReason })) : null, _jsx(TfButton, { ref: cancelRef, variant: "secondary", disabled: disabled, onClick: requestCancel, children: "Cancel" }), _jsx(TfButton, { variant: "primary", disabled: disabled || submitGated, onClick: onProceed, children: isLast
                         ? total === 1
                             ? "Submit answer"
                             : "Submit answers"

package/dist/components/react-tool-view.d.ts

@@ -1,4 +1,11 @@
 import { type ComponentType } from "react";
 import type { ToolViewAdapter, ToolViewProps } from "../core/tool-view.js";
+/**
+ * Wraps a React component as a tool view (or as an icon) for a registration;
+ * the component receives ToolViewProps and keeps its state across updates. It
+ * renders in its own React root, so your app's providers (router, theme, data
+ * clients) don't reach it, and a render error makes the assistant show the next
+ * matching view.
+ */
 export declare function reactToolView<TArgs = Record<string, unknown>, TResult = unknown>(component: ComponentType<ToolViewProps<TArgs, TResult>>): ToolViewAdapter<TArgs, TResult>;
 export declare const TOOL_VIEW_LATE_FAILURE_EVENT = "teaflask-tool-view-late-failure";

package/dist/components/subagent-count-pill.js

@@ -26,7 +26,7 @@ export function SubagentCountPill({ dispatches, threadId, renderPreview, }) {
         return null;
     }
     const variantIndices = coworkerIndicesOf(dispatches.values());
-    return (_jsxs("div", { ref: wrapperRef, "data-tf-subagent-pill": "", "data-tf-shelf-item": "", className: "tf:pointer-events-auto tf:relative tf:w-fit", onPointerEnter: onWrapperPointerEnter, onPointerLeave: onWrapperPointerLeave, onBlur: onWrapperBlur, children: [_jsxs(TfButton, { ref: triggerRef, "data-tf-glass": "", variant: "outline", className: "tf:min-h-11 tf:px-3 tf:md:px-2.5", "aria-label": `Subagents: ${label}`, "aria-expanded": open, "aria-controls": open ? rosterId : undefined, onPointerDown: onTriggerPointerDown, onPointerCancel: onTriggerPointerCancel, onFocus: onTriggerFocus, onClick: onTriggerClick, onKeyDown: onTriggerKeyDown, children: [_jsx(AgentIdentityMark, { register: "subagent", size: "md", className: "tf:text-tf-muted-foreground" }), roster.failed.length > 0 ? (_jsx("span", { "aria-hidden": true, className: "tf:size-1.5 tf:shrink-0 tf:rounded-full tf:bg-tf-destructive" })) : null, roster.running.length > 0 ? (_jsx(ShimmerText, { className: "tf:text-tf-muted-foreground", children: label })) : (label)] }), open ? (_jsx(SubagentRosterCard, { id: rosterId, roster: roster, variantIndices: variantIndices, threadId: threadId, renderPreview: renderPreview, triggerRef: triggerRef, onClose: close, refocusTrigger: refocusTrigger })) : null] }));
+    return (_jsxs("div", { ref: wrapperRef, "data-tf-subagent-pill": "", "data-tf-shelf-item": "", className: "tf:pointer-events-auto tf:relative tf:w-fit", onPointerEnter: onWrapperPointerEnter, onPointerLeave: onWrapperPointerLeave, onBlur: onWrapperBlur, children: [_jsxs(TfButton, { ref: triggerRef, "data-tf-glass": "", variant: "glassChip", className: "tf:min-h-11 tf:px-3 tf:md:px-2.5", "aria-label": `Subagents: ${label}`, "aria-expanded": open, "aria-controls": open ? rosterId : undefined, onPointerDown: onTriggerPointerDown, onPointerCancel: onTriggerPointerCancel, onFocus: onTriggerFocus, onClick: onTriggerClick, onKeyDown: onTriggerKeyDown, children: [_jsx(AgentIdentityMark, { register: "subagent", size: "md", className: "tf:text-tf-muted-foreground" }), roster.failed.length > 0 ? (_jsx("span", { "aria-hidden": true, className: "tf:size-1.5 tf:shrink-0 tf:rounded-full tf:bg-tf-destructive" })) : null, roster.running.length > 0 ? (_jsx(ShimmerText, { className: "tf:text-tf-muted-foreground", children: label })) : (label)] }), open ? (_jsx(SubagentRosterCard, { id: rosterId, roster: roster, variantIndices: variantIndices, threadId: threadId, renderPreview: renderPreview, triggerRef: triggerRef, onClose: close, refocusTrigger: refocusTrigger })) : null] }));
 }
 function SubagentRosterCard({ id, roster, variantIndices, threadId, renderPreview, triggerRef, onClose, refocusTrigger, }) {
     const cardRef = useRef(null);
@@ -87,7 +87,7 @@ function SubagentRosterLine({ entry, variantIndex, previewable, previewOpen, onP
                 entry.failed ? entry.note : null,
             ]
                 .filter((part) => part !== null)
-                .join(" — "), className: "tf:group/subagent tf:min-h-11 tf:w-full tf:justify-start tf:px-2 tf:py-1.5 tf:hover:bg-tf-accent", onPointerEnter: (event) => {
+                .join(" — "), className: "tf:group/subagent tf:min-h-11 tf:w-full tf:justify-start tf:px-2 tf:py-1.5 tf:hover:bg-tf-accent tf:hover:text-tf-accent-foreground", onPointerEnter: (event) => {
                 if (event.pointerType !== "touch") {
                     onPreviewOpener(event.currentTarget);
                     onPreviewChange(true);

package/dist/components/subagent-group-row.js

@@ -3,10 +3,9 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 import { activityTitleOf } from "../core/activity-title.js";
 import { ChevronRightIcon } from "lucide-react";
 import { createContext, useContext } from "react";
-import { dispatchFailed, dispatchIsPaused, dispatchIsRunning, } from "../contract/dispatches.js";
-import { subagentIdentityTokenOf } from "../core/agent-identity.js";
 import { coworkerIndicesOf, settledWorkedLabelOf, } from "../core/subagent-presence.js";
 import { subagentGroupHeadlineOf, subagentOutcomeCountsOf, } from "../core/subagent-rows.js";
+import { resolvedSubagentEntryOf, } from "../core/subagent-ledger-join.js";
 import { humanizedToolName, } from "../core/tool-call-display.js";
 import { toolCallPresentationOf } from "../core/tool-call-presentation.js";
 import { AgentIdentityMark } from "./agent-identity-mark.js";
@@ -21,30 +20,6 @@ const EMPTY_SUBAGENT_DISPATCHES = {
     byOrdinal: new Map(),
 };
 export const SubagentDispatchesContext = createContext(EMPTY_SUBAGENT_DISPATCHES);
-export function resolvedSubagentEntryOf(entry, byOrdinal) {
-    const ledger = entry.receipt != null ? byOrdinal.get(entry.receipt.ordinal) : undefined;
-    const ledgerLabel = ledger !== undefined && ledger.label !== "" ? ledger.label : null;
-    const childSessionId = ledger !== undefined && entry.receipt?.childSessionId != null
-        ? entry.receipt.childSessionId
-        : null;
-    const running = ledger !== undefined ? dispatchIsRunning(ledger) : entry.running;
-    const failed = ledger !== undefined ? dispatchFailed(ledger) : entry.failed;
-    return {
-        toolCallId: entry.toolCallId,
-        label: ledgerLabel ?? entry.label,
-        running,
-        failed,
-        cancelled: entry.cancelled,
-        note: (ledger !== undefined && dispatchFailed(ledger) ? ledger.error : null) ??
-            entry.note,
-        childSessionId,
-        identityToken: childSessionId !== null ? subagentIdentityTokenOf(childSessionId) : null,
-        ordinal: entry.receipt?.ordinal ?? null,
-        paused: ledger !== undefined && dispatchIsPaused(ledger),
-        startedAt: ledger !== undefined ? ledger.created_at : null,
-        settledAt: ledger !== undefined && !running ? ledger.updated_at : null,
-    };
-}
 export function SubagentGroupRow({ row }) {
     const join = useContext(SubagentDispatchesContext);
     const resolved = row.entries.map((entry) => resolvedSubagentEntryOf(entry, join.byOrdinal));

package/dist/components/subagent-preview-popover.js

@@ -43,7 +43,7 @@ export function SubagentPreviewPopover({ id, anchorRef, previewRef, label, child
             }
         };
     }, [anchorRef, previewRef]);
-    return (_jsxs("div", { ref: previewRef, id: id, role: "dialog", "aria-label": `Conversation preview: ${label}`, popover: "manual", tabIndex: -1, className: "tf:fixed tf:m-0 tf:overflow-visible tf:border-0 tf:bg-transparent tf:p-0 tf:text-tf-foreground tf:focus-visible:outline-2 tf:focus-visible:outline-offset-2 tf:focus-visible:outline-tf-ring", children: [_jsx("span", { "aria-hidden": true, "data-tf-subagent-preview-hover-bridge": "", className: "tf:pointer-events-auto tf:absolute tf:-inset-2" }), _jsx("div", { className: "tf:relative tf:h-full tf:w-full", children: children })] }));
+    return (_jsxs("div", { ref: previewRef, id: id, role: "dialog", "aria-label": `Conversation preview: ${label}`, popover: "manual", tabIndex: -1, className: "tf:fixed tf:m-0 tf:overflow-visible tf:border-0 tf:bg-transparent tf:p-0 tf:text-tf-popover-foreground tf:focus-visible:outline-2 tf:focus-visible:outline-offset-2 tf:focus-visible:outline-tf-ring", children: [_jsx("span", { "aria-hidden": true, "data-tf-subagent-preview-hover-bridge": "", className: "tf:pointer-events-auto tf:absolute tf:-inset-2" }), _jsx("div", { className: "tf:relative tf:h-full tf:w-full", children: children })] }));
 }
 function _previewPlacementOf(anchorRect, viewportWidth, viewportHeight) {
     const gutter = 16;

package/dist/components/subscription-connect-arms.js

@@ -33,11 +33,13 @@ export function ManageUsageLink({ provider, variant = "primary", }) {
 export function HeartbeatLine({ sentence, tone = "muted", }) {
     return (_jsxs("p", { className: tone === "muted"
             ? "tf:m-0 tf:flex tf:items-center tf:gap-1.5 tf:text-tf-label tf:text-tf-muted-foreground"
-            : "tf:m-0 tf:flex tf:items-center tf:gap-1.5 tf:text-tf-label tf:text-tf-foreground", role: "status", children: [_jsx("span", { "aria-hidden": true, className: "tf:size-1.5 tf:shrink-0 tf:animate-tf-pulse tf:rounded-full tf:bg-tf-foreground tf:motion-reduce:animate-none" }), sentence] }));
+            : "tf:m-0 tf:flex tf:items-center tf:gap-1.5 tf:text-tf-label", role: "status", children: [_jsx("span", { "aria-hidden": true, className: tone === "muted"
+                    ? "tf:size-1.5 tf:shrink-0 tf:animate-tf-pulse tf:rounded-full tf:bg-tf-foreground tf:motion-reduce:animate-none"
+                    : "tf:size-1.5 tf:shrink-0 tf:animate-tf-pulse tf:rounded-full tf:bg-current tf:motion-reduce:animate-none" }), sentence] }));
 }
-export function PopupBlocked({ authorization, onCancel, onTabOpened, }) {
-    return (_jsxs("div", { className: "tf:flex tf:flex-col tf:gap-2", children: [_jsx("p", { className: "tf:m-0 tf:text-tf-label tf:text-tf-foreground", role: "status", children: "Your browser blocked the sign-in window." }), _jsxs("div", { className: "tf:flex tf:flex-wrap tf:items-center tf:gap-2", children: [_jsx(TfLinkButton, { href: authorization.authorize_url, target: "_blank", rel: "opener", referrerPolicy: "no-referrer", onClick: onTabOpened, children: "Continue in a new tab" }), _jsx(TfButton, { variant: "ghost", onClick: onCancel, children: "Cancel" })] })] }));
+export function PopupBlocked({ onBegin, onCancel, }) {
+    return (_jsxs("div", { className: "tf:flex tf:flex-col tf:gap-2", children: [_jsx("p", { className: "tf:m-0 tf:text-tf-label", role: "status", children: "Your browser blocked the sign-in window. Allow pop-ups for this site, then try again." }), _jsxs("div", { className: "tf:flex tf:flex-wrap tf:items-center tf:gap-2", children: [_jsx(TfButton, { variant: "primary", onClick: onBegin, children: "Try again" }), _jsx(TfButton, { variant: "secondary", onClick: onCancel, children: "Cancel" })] })] }));
 }
 export function NotConnected({ name, onBegin, }) {
-    return (_jsxs("div", { className: "tf:flex tf:flex-col tf:gap-2", children: [_jsxs("div", { className: "tf:flex tf:flex-col tf:gap-1", role: "status", children: [_jsx("p", { className: "tf:m-0 tf:text-tf-heading tf:font-medium tf:text-tf-foreground", children: NOT_CONNECTED_HEADLINE }), _jsx("p", { className: "tf:m-0 tf:text-tf-label tf:text-tf-muted-foreground", children: notConnectedExplanationOf(name) })] }), _jsx(TfButton, { variant: "primary", className: "tf:self-start", onClick: onBegin, children: "Try again" })] }));
+    return (_jsxs("div", { className: "tf:flex tf:flex-col tf:gap-2", children: [_jsxs("div", { className: "tf:flex tf:flex-col tf:gap-1", role: "status", children: [_jsx("p", { className: "tf:m-0 tf:text-tf-heading tf:font-medium", children: NOT_CONNECTED_HEADLINE }), _jsx("p", { className: "tf:m-0 tf:text-tf-label tf:text-tf-muted-foreground", children: notConnectedExplanationOf(name) })] }), _jsx(TfButton, { variant: "primary", className: "tf:self-start", onClick: onBegin, children: "Try again" })] }));
 }