@teaflask/assistant 0.6.0 → 0.7.1

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" })] }));
 }

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

@@ -35,7 +35,7 @@ export function useSubscriptionConnectFlow(status, session, refreshSubscriptions
         noteSignedInRef.current = noteSignedIn;
     });
     useEffect(() => {
-        if (flow.kind !== "in_popup" && flow.kind !== "popup_blocked") {
+        if (flow.kind !== "in_popup") {
             return;
         }
         return _awaitTheCallback({
@@ -84,6 +84,10 @@ export function useSubscriptionConnectFlow(status, session, refreshSubscriptions
                 return;
             }
             const popup = window.open("about:blank", _POPUP_NAME, _POPUP_FEATURES);
+            if (popup === null) {
+                setFlow({ kind: "popup_blocked" });
+                return;
+            }
             void _begin(wires, popup);
         },
         disconnect: () => void _disconnect(wires),
@@ -93,11 +97,6 @@ export function useSubscriptionConnectFlow(status, session, refreshSubscriptions
             }
             setFlow({ kind: "idle" });
         },
-        noteTabOpened: () => {
-            if (flow.kind === "popup_blocked" && !flow.tabOpened) {
-                setFlow({ ...flow, tabOpened: true });
-            }
-        },
     };
 }
 function _isInProgress(flow) {
@@ -134,25 +133,20 @@ async function _begin(wires, popup) {
     setFlow({ kind: "starting" });
     try {
         const authorization = await beginSubscriptionAuthorization(wires.session, wires.provider);
-        const expiresAt = Date.now() + authorization.expires_in * 1000;
-        if (popup === null) {
-            setFlow({
-                kind: "popup_blocked",
-                authorization,
-                expiresAt,
-                tabOpened: false,
-            });
-        }
-        else if (popup.closed) {
+        if (popup.closed) {
             setFlow({ kind: "idle" });
         }
         else {
             popup.location.href = authorization.authorize_url;
-            setFlow({ kind: "in_popup", popup, expiresAt });
+            setFlow({
+                kind: "in_popup",
+                popup,
+                expiresAt: Date.now() + authorization.expires_in * 1000,
+            });
         }
     }
     catch (error) {
-        popup?.close();
+        popup.close();
         setFlow({ kind: "error", sentence: failureSentenceOf(error) });
     }
     finally {
@@ -214,34 +208,27 @@ function _awaitTheCallback(wires, flow) {
         if (!settle()) {
             return;
         }
-        if (flow.kind === "in_popup") {
-            flow.popup.close();
-        }
+        flow.popup.close();
         setFlow({ kind: "error", sentence: _SIGN_IN_EXPIRED_SENTENCE });
     }, Math.max(0, flow.expiresAt - Date.now()));
-    let closedWatch;
     let grace;
-    if (flow.kind === "in_popup") {
-        const { popup } = flow;
-        closedWatch = window.setInterval(() => {
-            if (!popup.closed || grace !== undefined) {
+    const { popup } = flow;
+    const closedWatch = window.setInterval(() => {
+        if (!popup.closed || grace !== undefined) {
+            return;
+        }
+        grace = window.setTimeout(() => {
+            if (!settle()) {
                 return;
             }
-            grace = window.setTimeout(() => {
-                if (!settle()) {
-                    return;
-                }
-                refreshSubscriptions();
-                setFlow({ kind: "checking", before: latestStatusRef.current });
-            }, _POPUP_CLOSED_GRACE_MS);
-        }, _POPUP_CLOSED_POLL_MS);
-    }
+            refreshSubscriptions();
+            setFlow({ kind: "checking", before: latestStatusRef.current });
+        }, _POPUP_CLOSED_GRACE_MS);
+    }, _POPUP_CLOSED_POLL_MS);
     return () => {
         window.removeEventListener("message", onMessage);
         window.clearTimeout(expiry);
-        if (closedWatch !== undefined) {
-            window.clearInterval(closedWatch);
-        }
+        window.clearInterval(closedWatch);
         if (grace !== undefined) {
             window.clearTimeout(grace);
         }
@@ -281,9 +268,9 @@ export function ProviderConnectSection({ status, session, refreshSubscriptions,
                         headline: NOT_CONNECTED_HEADLINE,
                         detail: notConnectedExplanationOf(name),
                     }
-                    : null, rechecking: recheck.rechecking, onRecheck: recheck.recheck, onReconnect: connect.begin, onDisconnect: connect.disconnect })) : (_jsx(ConnectFlow, { name: name, flow: connect.flow, errorSentence: connect.errorSentence, onBegin: connect.begin, onCancel: connect.cancel, onTabOpened: connect.noteTabOpened }))] }));
+                    : null, rechecking: recheck.rechecking, onRecheck: recheck.recheck, onReconnect: connect.begin, onDisconnect: connect.disconnect })) : (_jsx(ConnectFlow, { name: name, flow: connect.flow, errorSentence: connect.errorSentence, onBegin: connect.begin, onCancel: connect.cancel }))] }));
 }
-export function ConnectFlow({ name, flow, errorSentence, onBegin, onCancel, onTabOpened, }) {
+export function ConnectFlow({ name, flow, errorSentence, onBegin, onCancel, }) {
     if (flow.kind === "removed") {
         return (_jsx("p", { className: "tf:m-0 tf:text-tf-label tf:text-tf-muted-foreground", role: "status", children: "Disconnected." }));
     }
@@ -296,13 +283,11 @@ export function ConnectFlow({ name, flow, errorSentence, onBegin, onCancel, onTa
     if (flow.kind === "checking") {
         return _jsx(HeartbeatLine, { sentence: `Checking your ${name} connection…` });
     }
-    if (flow.kind === "in_popup" ||
-        (flow.kind === "popup_blocked" && flow.tabOpened)) {
-        const where = flow.kind === "in_popup" ? "window" : "tab";
-        return (_jsxs("div", { className: "tf:flex tf:flex-col tf:gap-2", children: [_jsx(HeartbeatLine, { sentence: `Finish signing in to ${name} in the ${where} that opened.` }), _jsx(TfButton, { variant: "ghost", className: "tf:self-start", onClick: onCancel, children: "Cancel" })] }));
+    if (flow.kind === "in_popup") {
+        return (_jsxs("div", { className: "tf:flex tf:flex-col tf:gap-2", children: [_jsx(HeartbeatLine, { sentence: `Finish signing in to ${name} in the window that opened.` }), _jsx(TfButton, { variant: "secondary", className: "tf:self-start", onClick: onCancel, children: "Cancel" })] }));
     }
     if (flow.kind === "popup_blocked") {
-        return (_jsx(PopupBlocked, { authorization: flow.authorization, onCancel: onCancel, onTabOpened: onTabOpened }));
+        return _jsx(PopupBlocked, { onBegin: onBegin, onCancel: onCancel });
     }
     if (flow.kind === "not_connected") {
         return _jsx(NotConnected, { name: name, onBegin: onBegin });

package/dist/components/subscription-connected-standing.js

@@ -10,11 +10,11 @@ export function ConnectedStanding({ name, status, errorSentence, outcome, rechec
     const active = status.state === "active";
     return (_jsxs("div", { className: "tf:flex tf:flex-col tf:gap-3", children: [_jsx(ConnectedStandingHeader, { name: name, status: status, actionsOpen: actionsOpen, actionsId: actionsId, onToggleActions: () => {
                     setActionsOpen((current) => !current);
-                } }), status.state === "bounced" ? null : (_jsxs("p", { className: "tf:m-0 tf:text-xs tf:text-tf-muted-foreground", children: ["Uses your ", name, " plan's included usage."] })), _jsx(StandingLine, { name: name, status: status, outcome: outcome, active: active }), status.offered ? null : (_jsxs("p", { className: "tf:m-0 tf:text-tf-label tf:text-tf-muted-foreground", children: [name, " sign-in is no longer offered here."] })), status.state === "bounced" && rechecking ? (_jsx(HeartbeatLine, { sentence: checkingPlanSentenceOf(name) })) : status.state === "bounced" ? (_jsx(BouncedRemedy, { name: name, status: status, onRecheck: onRecheck, onReconnect: onReconnect })) : null, errorSentence === null ? null : (_jsx("p", { className: "tf:m-0 tf:text-tf-label tf:text-tf-destructive", role: "alert", children: errorSentence })), actionsOpen ? (_jsxs("div", { id: actionsId, className: "tf:flex tf:flex-wrap tf:justify-end tf:gap-2 tf:border-t tf:pt-2", children: [status.bounce_cause === "quota" ? null : (_jsx(ManageUsageLink, { provider: status.provider, variant: "outline" })), _jsxs(TfButton, { variant: "outline", onClick: onDisconnect, children: ["Disconnect ", name] })] })) : null] }));
+                } }), status.state === "bounced" || !status.offered ? null : (_jsxs("p", { className: "tf:m-0 tf:text-xs tf:text-tf-muted-foreground", children: ["Uses your ", name, " plan's included usage."] })), _jsx(StandingLine, { name: name, status: status, outcome: outcome, active: active }), status.offered ? null : (_jsxs("p", { className: "tf:m-0 tf:text-tf-label tf:text-tf-muted-foreground", children: [name, " sign-in is no longer offered here."] })), status.state === "bounced" && rechecking ? (_jsx(HeartbeatLine, { sentence: checkingPlanSentenceOf(name) })) : status.state === "bounced" ? (_jsx(BouncedRemedy, { name: name, status: status, onRecheck: onRecheck, onReconnect: onReconnect })) : null, errorSentence === null ? null : (_jsx("p", { className: "tf:m-0 tf:text-tf-label tf:text-tf-destructive", role: "alert", children: errorSentence })), actionsOpen ? (_jsxs("div", { id: actionsId, className: "tf:flex tf:flex-wrap tf:justify-end tf:gap-2 tf:border-t tf:pt-2", children: [status.bounce_cause === "quota" ? null : (_jsx(ManageUsageLink, { provider: status.provider, variant: "outline" })), _jsxs(TfButton, { variant: "outline", onClick: onDisconnect, children: ["Disconnect ", name] })] })) : null] }));
 }
 function StandingLine({ name, status, outcome, active, }) {
     if (outcome !== null) {
-        return (_jsxs("div", { className: "tf:flex tf:flex-col tf:gap-1", role: "status", children: [_jsx("p", { className: "tf:m-0 tf:text-tf-label tf:font-medium tf:text-tf-foreground", children: outcome.headline }), _jsx("p", { className: "tf:m-0 tf:text-tf-label tf:text-tf-muted-foreground", children: outcome.detail })] }));
+        return (_jsxs("div", { className: "tf:flex tf:flex-col tf:gap-1", role: "status", children: [_jsx("p", { className: "tf:m-0 tf:text-tf-label tf:font-medium", children: outcome.headline }), _jsx("p", { className: "tf:m-0 tf:text-tf-label tf:text-tf-muted-foreground", children: outcome.detail })] }));
     }
     if (active) {
         return null;
@@ -22,7 +22,7 @@ function StandingLine({ name, status, outcome, active, }) {
     if (status.state === "verifying") {
         return (_jsx(HeartbeatLine, { sentence: standingSentenceOf(name, status), tone: "foreground" }));
     }
-    return (_jsx("p", { className: "tf:m-0 tf:text-tf-label tf:text-tf-foreground", role: "status", children: standingSentenceOf(name, status) }));
+    return (_jsx("p", { className: "tf:m-0 tf:text-tf-label", role: "status", children: standingSentenceOf(name, status) }));
 }
 function BouncedRemedy({ name, status, onRecheck, onReconnect, }) {
     if (status.bounce_cause === "quota") {
@@ -34,7 +34,7 @@ function BouncedRemedy({ name, status, onRecheck, onReconnect, }) {
     return (_jsxs(TfButton, { variant: "primary", className: "tf:self-start", onClick: onReconnect, children: ["Reconnect ", name] }));
 }
 function ConnectedStandingHeader({ name, status, actionsOpen, actionsId, onToggleActions, }) {
-    return (_jsxs("div", { className: "tf:flex tf:items-center tf:justify-between tf:gap-3", children: [_jsxs("div", { className: "tf:flex tf:min-w-0 tf:items-center tf:gap-2.5", children: [_jsx("span", { className: "tf:flex tf:size-8 tf:shrink-0 tf:items-center tf:justify-center tf:rounded-full tf:bg-tf-muted tf:text-tf-foreground", children: _jsx(OpenAiMarkIcon, {}) }), _jsxs("div", { className: "tf:flex tf:min-w-0 tf:flex-col", children: [_jsx("span", { className: "tf:truncate tf:text-tf-label tf:font-medium tf:text-tf-foreground", children: name }), _jsx("span", { className: "tf:truncate tf:text-xs tf:text-tf-muted-foreground", children: "AI subscription" })] })] }), _jsxs(TfButton, { variant: "outline", className: "tf:shrink-0", "aria-expanded": actionsOpen, "aria-controls": actionsId, onClick: onToggleActions, children: [_jsx("span", { "aria-hidden": true, className: stateDotClassOf(status) }), stateChipLabelOf(status), _jsx(ChevronDownIcon, {})] })] }));
+    return (_jsxs("div", { className: "tf:flex tf:items-center tf:justify-between tf:gap-3", children: [_jsxs("div", { className: "tf:flex tf:min-w-0 tf:items-center tf:gap-2.5", children: [_jsx("span", { className: "tf:flex tf:size-8 tf:shrink-0 tf:items-center tf:justify-center tf:rounded-full tf:bg-tf-muted", children: _jsx(OpenAiMarkIcon, {}) }), _jsxs("div", { className: "tf:flex tf:min-w-0 tf:flex-col", children: [_jsx("span", { className: "tf:truncate tf:text-tf-label tf:font-medium", children: name }), _jsx("span", { className: "tf:truncate tf:text-xs tf:text-tf-muted-foreground", children: "AI subscription" })] })] }), _jsxs(TfButton, { variant: "outline", className: "tf:shrink-0", "aria-expanded": actionsOpen, "aria-controls": actionsId, onClick: onToggleActions, children: [_jsx("span", { "aria-hidden": true, className: stateDotClassOf(status) }), stateChipLabelOf(status), _jsx(ChevronDownIcon, {})] })] }));
 }
 function stateDotClassOf(status) {
     if (status.state === "bounced" && status.bounce_cause !== "quota") {
@@ -43,14 +43,17 @@ function stateDotClassOf(status) {
     if (status.state === "bounced") {
         return "tf:size-1.5 tf:rounded-full tf:bg-tf-muted-foreground";
     }
-    return "tf:size-1.5 tf:rounded-full tf:bg-tf-foreground";
+    return "tf:size-1.5 tf:rounded-full tf:bg-current";
 }
 function stateChipLabelOf(status) {
     if (status.state === "verifying") {
         return "Verifying";
     }
     if (status.state === "bounced") {
-        return status.bounce_cause === "quota" ? "Limit reached" : "Reconnect";
+        if (status.bounce_cause === "quota") {
+            return "Limit reached";
+        }
+        return status.offered ? "Reconnect" : "Not working";
     }
     return "Connected";
 }

package/dist/components/subscription-plan-notice.js

@@ -15,8 +15,10 @@ export function SubscriptionPlanNotice() {
         return null;
     }
     const standing = statuses?.find((status) => Object.is(status.provider, due));
-    const active = standing?.connected === true && standing.state === "active";
-    if (!active || readPlanNoticeSeen(session.publishableKey, due)) {
+    const inUse = standing?.connected === true &&
+        standing.state === "active" &&
+        standing.offered;
+    if (!inUse || readPlanNoticeSeen(session.publishableKey, due)) {
         return null;
     }
     const name = providerNameOf(due);

package/dist/components/teaflask-assistant-provider.d.ts

@@ -13,27 +13,120 @@ import type { ServingApiError } from "../transport/serving-error.js";
 import type { TokenSession } from "../transport/token-session.js";
 import type { ToolViewRegistry } from "../core/tool-view.js";
 import type { AssistantSuggestionInput } from "./conversation-view.js";
+/**
+ * The identity props for a signed-in user, always passed together. When
+ * `userId` changes, including to undefined on sign-out, everything from the
+ * previous user is dropped and a fresh session starts.
+ */
 export interface TeaflaskAssistantIdentityProps {
+    /**
+     * Your stable id for the signed-in user. It must equal the `user_id` claim
+     * in the token that `getEndUserToken` returns, or the assistant shows a
+     * setup error instead of a conversation.
+     */
     userId: string;
+    /**
+     * Returns a short-lived token from your backend that proves who the user
+     * is: an HS256 JWT with `user_id` and `exp` (and optionally `email`),
+     * signed with the JWT secret from Settings → Keys in Teaflask. It is called
+     * whenever the assistant needs a new session token, and returning null
+     * continues anonymously.
+     */
     getEndUserToken: () => string | null | Promise<string | null>;
 }
+/**
+ * The identity props for a page with no signed-in user. Leave both `userId` and
+ * `getEndUserToken` unset, and the visitor chats anonymously.
+ */
 export interface TeaflaskAssistantAnonymousProps {
+    /** Leave unset for anonymous visitors. */
     userId?: undefined;
+    /** Leave unset for anonymous visitors. */
     getEndUserToken?: undefined;
 }
+/**
+ * Props for `TeaflaskAssistantProvider`. Pass the shared props, plus either
+ * both `userId` and `getEndUserToken` for a signed-in user or neither for an
+ * anonymous visitor.
+ */
 export type TeaflaskAssistantProviderProps = TeaflaskAssistantProviderBaseProps & (TeaflaskAssistantIdentityProps | TeaflaskAssistantAnonymousProps);
+/**
+ * The props shared by `TeaflaskAssistantProvider` and `TeaflaskAssistant`,
+ * except the identity pair. Changing `publishableKey`, `baseUrl` or `userId`
+ * starts a separate session.
+ */
 export interface TeaflaskAssistantProviderBaseProps {
+    /**
+     * Your agent's publishable key from Teaflask. It is meant for browser code,
+     * and requests are accepted only from your allowed origins.
+     */
     publishableKey: string;
+    /**
+     * The Teaflask API origin, which defaults to `https://api.teaflask.com`. A
+     * trailing slash is ignored.
+     */
     baseUrl?: string;
+    /**
+     * How this page calls your API when the agent runs an action, with the
+     * user's own cookies, headers or a request you build. Without it, the agent
+     * cannot run actions here and tells the user to do the step themselves.
+     */
     actionsAdapter?: ActionsAdapter;
+    /**
+     * Called with an app-relative path when the agent takes the user to a page,
+     * so wire it to your router. It may return a promise that resolves once
+     * your router has the navigation. Without it, the agent cannot navigate on
+     * this page.
+     */
     onNavigate?: (path: string) => void | Promise<void>;
+    /**
+     * Called with errors for your error reporting: a failed send or stop, a
+     * dropped stream, a conversation that fails to open, a failed session-token
+     * request, or a crash inside an assistant surface.
+     */
     onError?: (error: Error) => void;
+    /**
+     * Called with product analytics events (approval submits and stream
+     * failures) that you can forward to your own analytics. If it throws, the
+     * error goes to `onError`.
+     */
     onTelemetry?: (event: AssistantTelemetryEvent) => void;
+    /**
+     * Theme tokens and dark-mode overrides, compared by value, so passing a new
+     * object literal on every render is fine. Under a strict Content Security
+     * Policy this needs inline styles allowed (`style-src-attr`). Otherwise set
+     * the `--tf-` variables in your CSS instead.
+     */
     theme?: AssistantTheme;
+    /**
+     * Forces light, dark or OS-following (`"auto"`) colors on every assistant
+     * surface. Omit it to stay light unless an ancestor element carries
+     * `data-tf-theme="dark"`.
+     */
     mode?: AssistantThemeMode;
+    /**
+     * Your own logo or mascot, shown on the corner widget and on the drawer's
+     * welcome screen. It fills a 4rem square, so a bare `<svg viewBox>` or
+     * `<img>` works without sizing. Omit it, or pass a falsy value, to show the
+     * Teaflask flask.
+     */
     companionMark?: ReactNode;
+    /**
+     * Opening prompts for the drawer's welcome screen, compared by value. Omit
+     * it to use the prompts configured for your agent in Teaflask for the
+     * current page. Any value, even `[]`, replaces those entirely.
+     */
     suggestions?: readonly AssistantSuggestionInput[];
+    /**
+     * Your own components for displaying specific tools and actions in the
+     * conversation, keyed by tool name (`action__<slug>` for an action). Define
+     * the registry once at module scope rather than inside a component.
+     */
     toolViews?: ToolViewRegistry;
+    /**
+     * Your app content. Components inside it can use the assistant hooks, such
+     * as `useAssistantActivity` and `useConversation`.
+     */
     children?: ReactNode;
 }
 interface AssistantSessionValue {
@@ -65,5 +158,11 @@ interface AssistantSessionValue {
 }
 export declare function useAssistantSession(): AssistantSessionValue;
 export declare function useOptionalAssistantSession(): AssistantSessionValue | null;
+/**
+ * Connects to Teaflask and shares one live conversation with every assistant
+ * component and hook inside it, without rendering any UI of its own. Use it in
+ * place of `TeaflaskAssistant` when you place the surfaces yourself or build
+ * your own UI.
+ */
 export declare function TeaflaskAssistantProvider({ publishableKey, baseUrl, userId, getEndUserToken, actionsAdapter, onNavigate, onError, onTelemetry, theme, mode, companionMark, suggestions, toolViews, children, }: TeaflaskAssistantProviderProps): import("react").JSX.Element;
 export {};