@teaflask/assistant 0.3.0 → 0.7.0

package/dist/components/conversation-surfaces-provider.js

@@ -5,24 +5,6 @@ import { ApprovalsContext } from "./approval-context.js";
 import { ConversationContext } from "./conversation-context.js";
 import { ElicitationsContext, } from "./elicitation-context.js";
 import { useCell } from "./use-store-cell.js";
-/**
- * The provider-level provision of the three conversation surfaces: the
- * composer contract, the approval surface and the elicitation surface
- * used to be provided by the chrome — the conversation view and the
- * transcript — which made the hooks unusable without mounting package
- * chrome. They are store bindings, not chrome state, so they belong to
- * the provider: a bring-your-own-frontend host mounts
- * <TeaflaskAssistantProvider> alone and reads them through the
- * ./headless entry's hooks.
- *
- * Internal on purpose (mounted by the provider, exported from no entry):
- * the composition seam stays ours. A child component rather than more
- * hooks in the provider body so the provider itself never subscribes to
- * a cell — its children element is stable, so a cell update re-renders
- * only context consumers, never the host's whole subtree. store.composer
- * is not the keystroke cell (composerInput rides its own cell,
- * core/conversation-store), so this subscription stays coarse.
- */
 export function ConversationSurfacesProvider({ store, children, }) {
     const composerContract = useCell(store.composer);
     const approvalCards = useCell(store.approvals);
@@ -39,4 +21,3 @@ export function ConversationSurfacesProvider({ store, children, }) {
     }), [elicitationCards, store]);
     return (_jsx(ConversationContext.Provider, { value: composerContract, children: _jsx(ApprovalsContext.Provider, { value: approvalSurface, children: _jsx(ElicitationsContext.Provider, { value: elicitationSurface, children: children }) }) }));
 }
-//# sourceMappingURL=conversation-surfaces-provider.js.map

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

@@ -1,35 +1,27 @@
 import type { ReactNode } from "react";
 import type { AssistantConversation } from "./use-assistant-conversation.js";
 /**
- * Which of the four things the concierge does an opening prompt asks for.
- * The host writes the prompt; the package owns the glyph vocabulary, so a
- * customer's empty state can never drift off the icon set.
+ * 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;
 }
-/** A bare string is still accepted, and renders as an `ask`. */
-export type AssistantSuggestionInput = string | AssistantSuggestion;
 /**
- * The conversation core's one render body: the honest error banners, the
- * streamed transcript (remounted per send — the whole reconnect story),
- * and the composer-carrying empty state. Both surfaces render exactly
- * this; they differ only in the chrome around it. `suggestions` seeds the
- * empty state with host-supplied opening prompts — content is the host's,
- * never the package's.
+ * 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;
-    /** Which chrome this is ("page", "palette") — names the holder in the
-     *  transcript lease, so a double-mount report says who collided. */
     surface: string;
     suggestions?: readonly AssistantSuggestionInput[];
-    /** Host voice for the empty-state invitation. */
     welcomeTitle?: string;
-    /** The empty state's identity mark — supplied by host chrome or by the
-     *  companion drawer's own mark. */
     welcomeMark?: ReactNode;
 }): import("react").JSX.Element;
 export declare function TranscriptSkeleton(): import("react").JSX.Element;
@@ -37,7 +29,4 @@ export declare function SetupErrorState({ message, code, }: {
     message: string;
     code: string;
 }): import("react").JSX.Element;
-/** @public — read by the frontend's assistant-mirror parity test, not by an
- *  entry point: the serving kind enum and this glyph table never drift apart. */
 export declare const SUGGESTION_MARKS: Record<AssistantSuggestionKind, () => ReactNode>;
-//# sourceMappingURL=conversation-view.d.ts.map

package/dist/components/conversation-view.js

@@ -13,147 +13,56 @@ import { SurfaceBoundary } from "./surface-boundary.js";
 import { Transcript } from "./transcript.js";
 import { MessageList } from "./message-list.js";
 import { withPendingUserEcho } from "../core/transcript-rows.js";
-// The no-provider fallback (welcome-branch tests render the view bare):
-// a frozen no-gate cell, so the hook order never bends.
 const NO_GATE_CELL = new ObservableCell(NO_GATE);
 function _asSuggestion(input) {
     return typeof input === "string" ? { prompt: input } : input;
 }
-/**
- * The conversation core's one render body: the honest error banners, the
- * streamed transcript (remounted per send — the whole reconnect story),
- * and the composer-carrying empty state. Both surfaces render exactly
- * this; they differ only in the chrome around it. `suggestions` seeds the
- * empty state with host-supplied opening prompts — content is the host's,
- * never the package's.
- */
 export function ConversationView({ core, surface, suggestions, welcomeTitle, welcomeMark, }) {
-    // The sign-in gate: an agent whose access requires an identified
-    // visitor takes the whole conversation area — there is nothing an
-    // anonymous visitor could type that would serve, so the surface says
-    // so plainly instead of refusing sends one by one. The host site owns
-    // sign-in; wiring getEndUserToken is what clears this.
     const session = useOptionalAssistantSession();
     const gate = useCell(session?.conversationGate ?? NO_GATE_CELL);
-    return (
-    // Deliberately re-provided from the explicit `core` prop even though
-    // the provider now provisions the same store cell app-wide: the
-    // value is identical in production (inner provider wins), and it
-    // keeps this view mountable bare — the welcome-branch tests and any
-    // host that drives the view with its own core depend on that. The
-    // provider-level provision is the public, headless-facing one.
-    _jsx(ConversationContext.Provider, { value: core.composerContract, children: _jsx("div", { "data-tf-conversation": "", className: "tf:relative tf:flex tf:min-h-0 tf:min-w-0 tf:flex-1 tf:flex-col", children: _jsxs("div", { "data-tf-conversation-body": "", className: "tf:contents", children: [core.showInterruptionBanner ? (_jsxs(NoticeBanner, { children: ["The connection to the assistant was interrupted.", _jsx(TfButton, { variant: "ghost", onClick: core.retryStream, children: "Retry" })] })) : null, core.sendError !== null ? (_jsx(NoticeBanner, { children: core.sendError })) : null, core.pendingDecisionGap ? (_jsx(PendingDecisionGapNotice, { onRetry: () => {
+    return (_jsx(ConversationContext.Provider, { value: core.composerContract, children: _jsx("div", { "data-tf-conversation": "", className: "tf:relative tf:flex tf:min-h-0 tf:min-w-0 tf:flex-1 tf:flex-col", children: _jsxs("div", { "data-tf-conversation-body": "", className: "tf:contents", children: [core.showInterruptionBanner ? (_jsxs(NoticeBanner, { children: ["The connection to the assistant was interrupted.", _jsx(TfButton, { variant: "ghost", onClick: core.retryStream, children: "Retry" })] })) : null, core.sendError !== null ? (_jsx(NoticeBanner, { children: core.sendError })) : null, core.pendingDecisionGap ? (_jsx(PendingDecisionGapNotice, { onRetry: () => {
                             void core.refreshConversation();
-                        } })) : null, core.turnFailure !== null ? (_jsx(NoticeBanner, { children: core.turnFailure })) : null, gate.kind === "sign_in" ? (_jsx("div", { className: "tf:flex tf:flex-1 tf:items-center tf:justify-center tf:p-6", children: _jsx(SignInRequiredState, {}) })) : core.threadOpening ? (_jsx(TranscriptSkeleton, {})) : core.conversation !== null ? (
-                    // The top-level backstop: a throw anywhere in the
-                    // transcript composition degrades to a card, never into the
-                    // host's tree. The thread#nonce key rides the BOUNDARY, not
-                    // the child: a latched boundary never renders its children
-                    // again, so a key inside it is never reconciled and the
-                    // card would outlive every thread switch and Retry. Keyed
-                    // here, a switch or a reconnectNonce bump remounts boundary
-                    // and transcript together — the same full Transcript
-                    // remount the key always forced, now also discarding the
-                    // latched failure.
-                    _jsx(SurfaceBoundary, { surface: "transcript", children: _jsx(Transcript, { surface: surface }) }, `${core.conversation.thread.id}#${String(core.reconnectNonce)}`)) : (_jsx(SurfaceBoundary, { surface: "welcome", children: _jsx(EmptyConversation, { surface: surface, 
-                            // A gated conversation must not dangle live-looking opening
-                            // prompts over a card that says chatting is paused — a first
-                            // click that silently 403s reads as "the assistant is
-                            // broken".
-                            suggestions: gate.kind === "none" ? suggestions : undefined, welcomeTitle: welcomeTitle, welcomeMark: welcomeMark }) }))] }) }) }));
+                        } })) : null, core.turnFailure !== null ? (_jsx(NoticeBanner, { children: core.turnFailure })) : null, gate.kind === "sign_in" ? (_jsx("div", { className: "tf:flex tf:flex-1 tf:items-center tf:justify-center tf:p-6", children: _jsx(SignInRequiredState, {}) })) : core.threadOpening ? (_jsx(TranscriptSkeleton, {})) : core.conversation !== null ? (_jsx(SurfaceBoundary, { surface: "transcript", children: _jsx(Transcript, { surface: surface }) }, `${core.conversation.thread.id}#${String(core.reconnectNonce)}`)) : (_jsx(SurfaceBoundary, { surface: "welcome", children: _jsx(EmptyConversation, { surface: surface, suggestions: gate.kind === "none" ? suggestions : undefined, welcomeTitle: welcomeTitle, welcomeMark: welcomeMark }) }))] }) }) }));
 }
-// The access gate's whole-surface state: calm, never an error — the
-// workspace's policy simply requires a signed-in visitor, and the
-// host site owns the signing in. The "almost a 404" register: the
-// surface exists, this visitor just isn't admitted yet.
 function SignInRequiredState() {
     return (_jsxs("div", { className: "tf:max-w-md tf:text-center", children: [_jsx("h2", { className: "tf:text-tf-heading tf:font-medium", children: "This assistant is available to signed-in users." }), _jsx("p", { className: "tf:mt-1 tf:text-tf-label tf:text-tf-muted-foreground", children: "Sign in to this site to start chatting." })] }));
 }
-// The shape of a conversation while its turns are on the wire: a "you"
-// bubble and an answer column at the message rhythm, in the wash with no
-// borders — a skeleton is an expectation, not a card. aria-hidden: the
-// status story is the row that was clicked, not this placeholder.
-// Exported for the fixture bench (never from the package barrel).
 export function TranscriptSkeleton() {
     return (_jsx("div", { "aria-hidden": "true", "data-tf-skeleton": "", className: "tf:min-h-0 tf:flex-1 tf:overflow-hidden tf:px-4 tf:py-6", children: _jsxs("div", { className: "tf:mx-auto tf:flex tf:w-full tf:max-w-3xl tf:flex-col tf:gap-6", children: [_jsx("div", { className: "tf:flex tf:justify-end", children: _jsx("div", { className: "tf:h-8 tf:w-2/5 tf:rounded-xl tf:bg-tf-muted" }) }), _jsxs("div", { className: "tf:flex tf:flex-col tf:gap-2", children: [_jsx("div", { className: "tf:h-4 tf:w-full tf:rounded-tf tf:bg-tf-muted" }), _jsx("div", { className: "tf:h-4 tf:w-11/12 tf:rounded-tf tf:bg-tf-muted" }), _jsx("div", { className: "tf:h-4 tf:w-3/5 tf:rounded-tf tf:bg-tf-muted" })] }), _jsx("div", { className: "tf:flex tf:justify-end", children: _jsx("div", { className: "tf:h-8 tf:w-1/4 tf:rounded-xl tf:bg-tf-muted" }) }), _jsxs("div", { className: "tf:flex tf:flex-col tf:gap-2", children: [_jsx("div", { className: "tf:h-4 tf:w-10/12 tf:rounded-tf tf:bg-tf-muted" }), _jsx("div", { className: "tf:h-4 tf:w-1/2 tf:rounded-tf tf:bg-tf-muted" })] })] }) }));
 }
-// Loud, developer-facing: a broken key, origin allowlist, or end-user
-// signer must be impossible to miss during integration.
 export function SetupErrorState({ message, code, }) {
     return (_jsxs("div", { className: "tf:max-w-md tf:text-center", children: [_jsx("h2", { className: "tf:text-tf-heading tf:font-medium", children: "The assistant couldn't connect" }), _jsx("p", { className: "tf:mt-1 tf:text-tf-label tf:text-tf-muted-foreground", children: message }), _jsx("p", { className: "tf:mt-2 tf:font-mono tf:text-xs tf:text-tf-muted-foreground", children: code })] }));
 }
-// The first-run screen is the conversation's focal point: one question at
-// the display step, the chat bar as its floor, and the host's opening
-// prompts beneath. A mark above the question only where the surface has an
-// identity to show — the companion drawer passes its mark; the palette
-// and page stay markless. No subtitle: "answers come from the docs" is a
-// claim, and the prompts are the demonstration.
 function EmptyConversation({ surface, suggestions, welcomeTitle = "Where should we begin?", welcomeMark, }) {
     const { pendingEcho } = useConversation();
     const pendingRows = withPendingUserEcho([], pendingEcho);
-    // The surface name — already here as the transcript lease's holder
-    // label — is what says which chrome this is. The drawer gets the
-    // bottom-anchored welcome; the palette and page keep the centered one.
     if (surface === "companion") {
         return (_jsx(CompanionWelcome, { suggestions: suggestions, welcomeTitle: welcomeTitle, welcomeMark: welcomeMark, pendingRows: pendingRows }));
     }
     return (_jsx("div", { className: "tf:flex tf:min-h-0 tf:flex-1 tf:flex-col " +
             (pendingEcho === null ? "tf:overflow-y-auto" : ""), children: _jsxs("div", { className: pendingEcho === null
                 ? "tf:my-auto tf:flex tf:w-full tf:flex-col tf:pt-4 tf:pb-16"
-                : "tf:contents", children: [pendingEcho !== null ? (
-                // Bare `live`: this branch exists only while the send is in
-                // flight, and the standalone "Working…" headline must claim the
-                // beat from the instant of submit — the store sets the turn before
-                // sendMessage's finally clears pendingSend, so the handoff to
-                // Transcript has no dead frame.
-                _jsx(SurfaceBoundary, { surface: "message-list", children: _jsx(MessageList, { rows: pendingRows, cards: [], live: true }) })) : (_jsxs("div", { className: "tf:flex tf:items-center tf:justify-center tf:gap-2 tf:px-6 tf:pb-5 tf:text-center", children: [_jsx("span", { "data-tf-host-view": "", className: "tf:contents", children: welcomeMark }), _jsx("h2", { className: "tf:text-3xl tf:font-semibold tf:tracking-[-0.04em] tf:text-balance", children: welcomeTitle })] })), _jsx(SurfaceBoundary, { surface: "composer", children: _jsx(Composer, { compact: pendingEcho === null, surface: surface }) }), pendingEcho === null &&
+                : "tf:contents", children: [pendingEcho !== null ? (_jsx(SurfaceBoundary, { surface: "message-list", children: _jsx(MessageList, { rows: pendingRows, cards: [], live: true }) })) : (_jsxs("div", { className: "tf:flex tf:items-center tf:justify-center tf:gap-2 tf:px-6 tf:pb-5 tf:text-center", children: [_jsx("span", { "data-tf-host-view": "", className: "tf:contents", children: welcomeMark }), _jsx("h2", { className: "tf:text-3xl tf:font-semibold tf:tracking-[-0.04em] tf:text-balance", children: welcomeTitle })] })), _jsx(SurfaceBoundary, { surface: "composer", children: _jsx(Composer, { compact: pendingEcho === null, surface: surface }) }), pendingEcho === null &&
                     suggestions !== undefined &&
                     suggestions.length > 0 ? (_jsx("div", { className: "tf:px-4 tf:pb-4", children: _jsx("div", { className: "tf:mx-auto tf:flex tf:w-full tf:max-w-xl tf:flex-col", children: _jsx(SuggestionRows, { suggestions: suggestions }) }) })) : null] }) }));
 }
-// The drawer's edition of the welcome, compose-window anatomy: the mark,
-// the question, and the prompts centered in the flexible upper space;
-// the composer pinned to the panel's bottom edge — the same relationship
-// it has to a live transcript, so sending the first message moves
-// nothing under the caret.
 function CompanionWelcome({ suggestions, welcomeTitle, welcomeMark, pendingRows, }) {
-    return (
-    // Its own inline-size container, deliberately NOT the panel: sizing
-    // the welcome against its measure must not leak containment onto
-    // the popover geometry or the shared palette/page markup above.
-    _jsxs("div", { className: "tf:@container tf:flex tf:min-h-0 tf:min-w-0 tf:flex-1 tf:flex-col", children: [pendingRows.length > 0 ? (
-            // Bare `live`, same reason as EmptyConversation's echo branch:
-            // this renders only mid-send, and the echo must carry the
-            // standalone Working… headline until Transcript takes over.
-            _jsx(SurfaceBoundary, { surface: "message-list", children: _jsx(MessageList, { rows: pendingRows, cards: [], live: true }) })) : (_jsx("div", { className: "tf:flex tf:min-h-0 tf:flex-1 tf:flex-col tf:overflow-y-auto", children: _jsxs("div", { className: suggestions !== undefined && suggestions.length > 0
+    return (_jsxs("div", { className: "tf:@container tf:flex tf:min-h-0 tf:min-w-0 tf:flex-1 tf:flex-col", children: [pendingRows.length > 0 ? (_jsx(SurfaceBoundary, { surface: "message-list", children: _jsx(MessageList, { rows: pendingRows, cards: [], live: true }) })) : (_jsx("div", { className: "tf:flex tf:min-h-0 tf:flex-1 tf:flex-col tf:overflow-y-auto", children: _jsxs("div", { className: suggestions !== undefined && suggestions.length > 0
                         ? "tf:my-auto tf:flex tf:w-full tf:flex-col tf:pt-4 tf:pb-6"
                         : "tf:my-auto tf:flex tf:w-full tf:flex-col tf:pt-16 tf:pb-6", children: [_jsx("div", { className: "tf:flex tf:justify-center", children: welcomeMark }), _jsx("div", { className: "tf:px-6 tf:pt-3 tf:pb-5 tf:text-center", children: _jsx("h2", { className: "tf:text-xl tf:font-semibold tf:tracking-[-0.04em] tf:text-balance tf:@md:text-2xl", children: welcomeTitle }) }), suggestions !== undefined && suggestions.length > 0 ? (_jsx("div", { className: "tf:px-4", children: _jsx("div", { className: "tf:mx-auto tf:flex tf:w-full tf:max-w-3xl tf:flex-col", children: _jsx(SuggestionRows, { suggestions: suggestions }) }) })) : null] }) })), _jsx("div", { className: "tf:shrink-0", children: _jsx(SurfaceBoundary, { surface: "composer", children: _jsx(Composer, { surface: "companion" }) }) })] }));
 }
-/** @public — read by the frontend's assistant-mirror parity test, not by an
- *  entry point: the serving kind enum and this glyph table never drift apart. */
 export const SUGGESTION_MARKS = {
     ask: SearchIcon,
     review: FlagIcon,
     write: ComposeIcon,
     learn: BookIcon,
 };
-// The kind is host data, and the script-tag distribution's hosts are plain
-// JS — nothing type-checks their suggestion objects. An unrecognized kind
-// takes the default glyph instead of rendering `undefined` as a component.
-// The parameter is `string`, not the union, on purpose: inside this
-// function the value is untrusted. Own-property lookup, not plain indexing:
-// an untrusted key naming something on Object.prototype ("constructor")
-// would resolve to the inherited member — truthy — and hand React a non-component.
 function _suggestionMarkOf(kind) {
     const named = kind ?? "ask";
     return Object.hasOwn(SUGGESTION_MARKS, named)
         ? SUGGESTION_MARKS[named]
         : SUGGESTION_MARKS.ask;
 }
-// Opening prompts, as rows in the composer's own column, not pills: three
-// pills of unequal width read as debris and wrap into a pile at 390px (and
-// inside the companion drawer's 384px column a sentence-length prompt wraps
-// inside its own pill). Rows share the composer's left edge, and the
-// leading glyph keeps them from reading as autocomplete.
 function SuggestionRows({ suggestions, }) {
     const { busy, sendMessage } = useConversation();
     return (_jsx(_Fragment, { children: suggestions.map(_asSuggestion).map((suggestion) => {
@@ -163,4 +72,3 @@ function SuggestionRows({ suggestions, }) {
                 }, children: [_jsx("span", { "data-tf-prompt-mark": "", className: "tf:flex tf:shrink-0", children: _jsx(Mark, {}) }), _jsx("span", { className: "tf:min-w-0 tf:flex-1 tf:line-clamp-2", children: suggestion.prompt }), _jsx("span", { "data-tf-prompt-go": "", className: "tf:flex tf:shrink-0 tf:text-tf-muted-foreground", children: _jsx(ArrowRightIcon, {}) })] }, suggestion.prompt));
         }) }));
 }
-//# sourceMappingURL=conversation-view.js.map

package/dist/components/copy-text-button.js

@@ -4,16 +4,6 @@ import { CheckIcon, CopyIcon } from "lucide-react";
 import { useEffect, useRef, useState } from "react";
 import { TfButton } from "./primitives/button.js";
 const COPIED_FLASH_MS = 2000;
-/** The package's ONE copy-to-clipboard affordance — the quiet icon
- *  button, the 2s "Copied" flash, and the permission posture every copy
- *  surface shares: a host page without clipboard access simply never
- *  confirms (the reader can still select the text). Shared by the code
- *  block ("Copy code") and the generic fallback frame ("Copy result")
- *  so the flash-timer lifecycle and failure behaviour can never drift
- *  between them. Generalized from the code block's own button: with the
- *  same label the rendered DOM and accessible names are byte-identical
- *  to the original, so the code block's baselined pixels never moved.
- */
 export function CopyTextButton({ text, label, className, }) {
     const [copied, setCopied] = useState(false);
     const flash = useRef(null);
@@ -27,8 +17,6 @@ export function CopyTextButton({ text, label, className, }) {
             await navigator.clipboard.writeText(text);
         }
         catch {
-            // A host page without clipboard permission: the affordance simply
-            // does not confirm; the reader can still select the text.
             return;
         }
         setCopied(true);
@@ -43,4 +31,3 @@ export function CopyTextButton({ text, label, className, }) {
             void copy();
         }, children: copied ? (_jsx(CheckIcon, { "aria-hidden": true, className: "tf:size-3.5" })) : (_jsx(CopyIcon, { "aria-hidden": true, className: "tf:size-3.5" })) }));
 }
-//# sourceMappingURL=copy-text-button.js.map

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

@@ -1,27 +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[];
-    /** Submit the whole question set at once — the ONE POST for the set;
-     *  the panel calls it only when every question has an answer. */
+    /**
+     * 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>;
-    /** Dismiss the whole set: no partial answers, a distinct outcome. */
+    /**
+     * 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 question-set drafts, keyed by interrupt id then question id —
-     *  store-owned so navigation, remount and reconnect never lose them. */
+    /**
+     * 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>;
-/** The elicitation surface — live under <TeaflaskAssistantProvider>;
- *  outside one it is the inert-but-loud guard above, so a stray
- *  submit or cancel still refuses to dissolve into a no-op. */
+/**
+ * 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;
-/** The cards anchored to one tool row — consumed by the row projection:
- *  in the shelf composition the pending panel lives in the suspension
- *  queue while the answered receipt and the expired note settle at the
- *  pause point; shelf-less hosts still mount every status there. */
 export declare function anchoredElicitationsFor(cards: readonly ElicitationCardModel[], toolCallId: string): ElicitationCardModel[];
-//# sourceMappingURL=elicitation-context.d.ts.map

package/dist/components/elicitation-context.js

@@ -1,13 +1,6 @@
 "use client";
 import { createContext, useContext } from "react";
 import { QuestionDraftStore } from "../core/question-drafts.js";
-// Inert for rendering, loud on use — the approval guard's rule, applied
-// here too because useElicitations is public API: outside a provider
-// nothing can be pending, so `cards` is empty and no panel ever mounts.
-// But a host calling the submit or cancel anyway — its question UI
-// mounted above the provider, say — must never see a member's answers
-// dissolve into a successful no-op: the console says so and the promise
-// rejects, reaching the host's exception capture.
 const EMPTY_ELICITATION_SURFACE = {
     cards: [],
     submitQuestionAnswers: (card) => {
@@ -23,17 +16,9 @@ const EMPTY_ELICITATION_SURFACE = {
     drafts: new QuestionDraftStore(),
 };
 export const ElicitationsContext = createContext(EMPTY_ELICITATION_SURFACE);
-/** The elicitation surface — live under <TeaflaskAssistantProvider>;
- *  outside one it is the inert-but-loud guard above, so a stray
- *  submit or cancel still refuses to dissolve into a no-op. */
 export function useElicitations() {
     return useContext(ElicitationsContext);
 }
-/** The cards anchored to one tool row — consumed by the row projection:
- *  in the shelf composition the pending panel lives in the suspension
- *  queue while the answered receipt and the expired note settle at the
- *  pause point; shelf-less hosts still mount every status there. */
 export function anchoredElicitationsFor(cards, toolCallId) {
     return cards.filter((card) => card.anchored && card.toolCallId === toolCallId);
 }
-//# sourceMappingURL=elicitation-context.js.map

package/dist/components/elicitation-receipt-row.js

@@ -1,8 +1,6 @@
 "use client";
 import { jsx as _jsx } from "react/jsx-runtime";
 import { ToolRow } from "./tool-row.js";
-// The temporary receipt in a shelf-less host uses the same registered
-// tool view as the durable transcript row once its result arrives.
 export function QuestionSetReceiptRow({ receipt, }) {
     return (_jsx(ToolRow, { view: {
             toolName: "ask_user",
@@ -16,4 +14,3 @@ export function QuestionSetReceiptRow({ receipt, }) {
             },
         } }));
 }
-//# sourceMappingURL=elicitation-receipt-row.js.map

package/dist/components/human-file-size.js

@@ -1,6 +1,3 @@
-// One spelling of a byte count everywhere a member reads one. Kept
-// React-free in its own module so the ./transcript entry can re-export
-// it without dragging the attachment chips' React closure along.
 export function humanFileSize(byteSize) {
     if (byteSize >= 1024 * 1024) {
         return `${(byteSize / (1024 * 1024)).toFixed(1)} MB`;
@@ -10,4 +7,3 @@ export function humanFileSize(byteSize) {
     }
     return `${String(byteSize)} B`;
 }
-//# sourceMappingURL=human-file-size.js.map

package/dist/components/icons.js

@@ -1,54 +1,31 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-// The package's own icon strokes (it ships no icon library): 16-grid,
-// 1.5 stroke, round caps — the same voice as the chassis' lucide set.
 export function ComposeIcon() {
     return (_jsxs("svg", { viewBox: "0 0 16 16", "aria-hidden": "true", className: "tf:size-4 tf:shrink-0", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", children: [_jsx("path", { d: "M8 2.5H4A1.5 1.5 0 0 0 2.5 4v8A1.5 1.5 0 0 0 4 13.5h8a1.5 1.5 0 0 0 1.5-1.5V8" }), _jsx("path", { d: "M12.3 2.3a1.2 1.2 0 0 1 1.7 1.7L8.5 9.5l-2.3.6.6-2.3z" })] }));
 }
 export function ArrowUpIcon() {
     return (_jsx("svg", { viewBox: "0 0 16 16", "aria-hidden": "true", className: "tf:size-4 tf:shrink-0", fill: "none", stroke: "currentColor", strokeWidth: "1.75", strokeLinecap: "round", strokeLinejoin: "round", children: _jsx("path", { d: "M8 12.5v-9M4 7l4-3.5L12 7" }) }));
 }
-// The stop square: the send arrow's busy-state counterpart — a
-// filled rounded square, the universal "stop generating" glyph.
 export function StopIcon() {
     return (_jsx("svg", { viewBox: "0 0 16 16", "aria-hidden": "true", className: "tf:size-4 tf:shrink-0", fill: "currentColor", stroke: "none", children: _jsx("rect", { x: "4.25", y: "4.25", width: "7.5", height: "7.5", rx: "1.5" }) }));
 }
-// The drawer header's disclosure arrow — it points at the history menu
-// it drops open. The drawn twin of the transcript's lucide chevron,
-// package-local because the minimized companion's static graph must stay
-// transcript-free (importing anything from lucide-react drags its barrel
-// into the closure the bundle test guards).
 export function ChevronDownIcon() {
     return (_jsx("svg", { viewBox: "0 0 16 16", "aria-hidden": "true", className: "tf:size-4 tf:shrink-0", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", children: _jsx("path", { d: "M3.5 6l4.5 4.5L12.5 6" }) }));
 }
-// The drawer's minimize affordance: a plain dash, never an X — dismissing
-// the drawer collapses it back into the perch, and both the conversation
-// and the companion survive. An X would promise a destruction that never
-// happens.
 export function MinimizeIcon() {
     return (_jsx("svg", { viewBox: "0 0 16 16", "aria-hidden": "true", className: "tf:size-4 tf:shrink-0", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", children: _jsx("path", { d: "M3.5 8h9" }) }));
 }
-// The mode switcher's trigger: the drawer's silhouette with the docked
-// column it can become. Package-local like every stroke here — the
-// minimized companion's static graph must stay icon-library-free.
 export function SidebarIcon() {
     return (_jsxs("svg", { viewBox: "0 0 16 16", "aria-hidden": "true", className: "tf:size-4 tf:shrink-0", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", children: [_jsx("rect", { x: "2.5", y: "2.5", width: "11", height: "11", rx: "1.5" }), _jsx("path", { d: "M9.5 2.5v11" })] }));
 }
-// The active row's mark in the mode menu.
 export function CheckIcon() {
     return (_jsx("svg", { viewBox: "0 0 16 16", "aria-hidden": "true", className: "tf:size-4 tf:shrink-0", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", children: _jsx("path", { d: "M3 8.5l3.2 3L13 4.5" }) }));
 }
 export function CloseIcon() {
     return (_jsx("svg", { viewBox: "0 0 16 16", "aria-hidden": "true", className: "tf:size-4 tf:shrink-0", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", children: _jsx("path", { d: "M4 4l8 8M12 4l-8 8" }) }));
 }
-// The prompt rows' trailing affordance: present but transparent until the
-// row is hovered, so the column's right edge doesn't twitch on approach.
 export function ArrowRightIcon() {
     return (_jsx("svg", { viewBox: "0 0 16 16", "aria-hidden": "true", className: "tf:size-4 tf:shrink-0", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", children: _jsx("path", { d: "M3.5 8h9M9 4.5L12.5 8 9 11.5" }) }));
 }
-// The opening prompts' capability glyphs. Four classes, because four is
-// what the concierge actually does: look something up, judge the state of
-// the docs, write one, explain the product. The host picks the class; the
-// stroke belongs to the package.
 export function SearchIcon() {
     return (_jsxs("svg", { viewBox: "0 0 16 16", "aria-hidden": "true", className: "tf:size-4 tf:shrink-0", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", children: [_jsx("circle", { cx: "7.2", cy: "7.2", r: "4.2" }), _jsx("path", { d: "M10.4 10.4L13.5 13.5" })] }));
 }
@@ -64,11 +41,6 @@ export function FileIcon() {
 export function PlusIcon() {
     return (_jsx("svg", { viewBox: "0 0 16 16", "aria-hidden": "true", className: "tf:size-4 tf:shrink-0", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", children: _jsx("path", { d: "M8 3.2v9.6M3.2 8h9.6" }) }));
 }
-// The OpenAI blossom, monochrome (the provider chip's mark): a filled
-// brand glyph, not one of the package's 16-grid strokes — it identifies
-// the visitor's own service, in ink like everything else (Graphite's
-// No-Accent law covers marks too).
 export function OpenAiMarkIcon() {
     return (_jsx("svg", { viewBox: "0 0 24 24", "aria-hidden": "true", className: "tf:size-3.5 tf:shrink-0", fill: "currentColor", children: _jsx("path", { d: "M22.2819 9.8211a5.9847 5.9847 0 0 0-.5157-4.9108 6.0462 6.0462 0 0 0-6.5098-2.9A6.0651 6.0651 0 0 0 4.9807 4.1818a5.9847 5.9847 0 0 0-3.9977 2.9 6.0462 6.0462 0 0 0 .7427 7.0966 5.98 5.98 0 0 0 .511 4.9107 6.051 6.051 0 0 0 6.5146 2.9001A5.9847 5.9847 0 0 0 13.2599 24a6.0557 6.0557 0 0 0 5.7718-4.2058 5.9894 5.9894 0 0 0 3.9977-2.9001 6.0557 6.0557 0 0 0-.7475-7.0729zm-9.022 12.6081a4.4755 4.4755 0 0 1-2.8764-1.0408l.1419-.0804 4.7783-2.7582a.7948.7948 0 0 0 .3927-.6813v-6.7369l2.02 1.1686a.071.071 0 0 1 .038.052v5.5826a4.504 4.504 0 0 1-4.4945 4.4944zm-9.6607-4.1254a4.4708 4.4708 0 0 1-.5346-3.0137l.142.0852 4.783 2.7582a.7712.7712 0 0 0 .7806 0l5.8428-3.3685v2.3324a.0804.0804 0 0 1-.0332.0615L9.74 19.9502a4.4992 4.4992 0 0 1-6.1408-1.6464zM2.3408 7.8956a4.485 4.485 0 0 1 2.3655-1.9728V11.6a.7664.7664 0 0 0 .3879.6765l5.8144 3.3543-2.0201 1.1685a.0757.0757 0 0 1-.071 0l-4.8303-2.7865A4.504 4.504 0 0 1 2.3408 7.872zm16.5963 3.8558L13.1038 8.364 15.1192 7.2a.0757.0757 0 0 1 .071 0l4.8303 2.7913a4.4944 4.4944 0 0 1-.6765 8.1042v-5.6772a.79.79 0 0 0-.407-.667zm2.0107-3.0231l-.142-.0852-4.7735-2.7818a.7759.7759 0 0 0-.7854 0L9.409 9.2297V6.8974a.0662.0662 0 0 1 .0284-.0615l4.8303-2.7866a4.4992 4.4992 0 0 1 6.6802 4.66zM8.3065 12.863l-2.02-1.1638a.0804.0804 0 0 1-.038-.0567V6.0742a4.4992 4.4992 0 0 1 7.3757-3.4537l-.142.0805L8.704 5.459a.7948.7948 0 0 0-.3927.6813zm1.0976-2.3654l2.602-1.4998 2.6069 1.4998v2.9994l-2.5974 1.4997-2.6067-1.4997Z" }) }));
 }
-//# sourceMappingURL=icons.js.map

package/dist/components/lazy-body.js

@@ -3,27 +3,6 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Component, Suspense } from "react";
 import { TfButton } from "./primitives/button.js";
 import { useAssistantSession } from "./teaflask-assistant-provider.js";
-// The wrapper every on-demand surface body mounts behind: the Suspense
-// placeholder while its chunk arrives, and — the part that matters — an
-// error boundary for when the chunk never does.
-//
-// A dynamic import can fail for the ordinary reasons (a visitor's
-// network drops mid-fetch), and for one the script-tag distribution
-// creates: that origin serves a single build, so a deploy deletes the
-// previous build's chunks, and a returning visitor whose cached entry
-// is a few minutes old asks for a chunk hash that no longer exists.
-// Immutable chunk caching narrows this to a body the visitor had never
-// opened before, but doesn't close it. React.lazy has no recovery of
-// its own — an import rejection throws during render, and without a
-// boundary above it the whole assistant unmounts, taking a working
-// conversation down over one missing file.
-//
-// Retrying the import cannot help: the file is genuinely gone from the
-// server, and a fresh entry is what knows the new hashes. So the
-// fallback asks for a reload and lets the visitor choose. We never
-// reload the page ourselves — this widget lives inside someone else's
-// app, and a form half-filled elsewhere on the page is not ours to
-// discard.
 export function LazyBody({ children }) {
     const { reportError } = useAssistantSession();
     return (_jsx(LazyBodyBoundary, { onFailure: reportError, children: _jsx(Suspense, { fallback: _jsx(BodyNotice, { children: "Loading\u2026" }), children: children }) }));
@@ -37,8 +16,6 @@ class LazyBodyBoundary extends Component {
         return { failed: true };
     }
     componentDidCatch(error, info) {
-        // The host's observer hears it, and the console carries the stack
-        // for whoever is actually debugging the page.
         this.props.onFailure(error);
         console.error("[teaflask-assistant] A surface failed to load.", error, info.componentStack);
     }
@@ -51,4 +28,3 @@ class LazyBodyBoundary extends Component {
                     }, children: "Reload the page" })] }));
     }
 }
-//# sourceMappingURL=lazy-body.js.map

package/dist/components/markdown/assistant-markdown.js

@@ -7,8 +7,6 @@ const COMPONENTS = {
     pre: preBlockFor(CodeBlock),
     a: TranscriptLink,
 };
-/** The assistant message body, assistant-ui register. */
 export function AssistantMarkdown({ children }) {
     return (_jsx("div", { "data-tf-markdown": "", className: "tf:min-w-0 tf:text-tf-body", children: _jsx(MarkdownBlocks, { components: COMPONENTS, children: children }) }));
 }
-//# sourceMappingURL=assistant-markdown.js.map

package/dist/components/markdown/code-block.js

@@ -1,19 +1,8 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-// The adopted register — bake-off 2026-07-30 (assistant-ui `markdown-text`'s code block): a
-// header bar naming the language with an always-visible copy affordance,
-// the code pane attached beneath — the block reads as a small tool.
-// Adapted to the --tf-* contract and the package's primitives; visual
-// decisions are assistant-ui's. The plain <pre> paints immediately;
-// shiki's lazy chunk upgrades it in place (Graphite ink levels via the
-// --shiki-* variables in styles.css).
 import { CopyTextButton } from "../copy-text-button.js";
 import { useHighlightedHtml } from "./use-highlighted-html.js";
 export function CodeBlock({ code, language, }) {
     const highlighted = useHighlightedHtml(code, language);
-    return (_jsxs("div", { className: "tf:my-3 tf:flex tf:w-full tf:flex-col tf:first:mt-0 tf:last:mb-0", children: [_jsxs("div", { className: "tf:flex tf:items-center tf:justify-between tf:rounded-t-xl tf:border tf:border-b-0 tf:bg-tf-muted tf:px-3.5 tf:py-1", children: [_jsx("span", { className: "tf:text-xs tf:font-medium tf:text-tf-muted-foreground tf:lowercase", children: language ?? "text" }), _jsx(CopyTextButton, { text: code, label: "Copy code" })] }), highlighted === null ? (_jsx("pre", { className: "tf:overflow-x-auto tf:rounded-b-xl tf:border tf:p-3.5 tf:text-tf-label tf:leading-relaxed", children: _jsx("code", { className: "tf:font-mono", children: code }) })) : (_jsx("div", { "data-tf-code-html": "", className: "tf:overflow-x-auto tf:rounded-b-xl tf:border tf:p-3.5 tf:font-mono tf:text-tf-label tf:leading-relaxed", 
-                // shiki's output: our own trusted pipeline — the code text is
-                // tokenized into spans, never injected as markup.
-                dangerouslySetInnerHTML: { __html: highlighted } }))] }));
+    return (_jsxs("div", { className: "tf:my-3 tf:flex tf:w-full tf:flex-col tf:first:mt-0 tf:last:mb-0", children: [_jsxs("div", { className: "tf:flex tf:items-center tf:justify-between tf:rounded-t-xl tf:border tf:border-b-0 tf:bg-tf-muted tf:px-3.5 tf:py-1", children: [_jsx("span", { className: "tf:text-xs tf:font-medium tf:text-tf-muted-foreground tf:lowercase", children: language ?? "text" }), _jsx(CopyTextButton, { text: code, label: "Copy code" })] }), highlighted === null ? (_jsx("pre", { className: "tf:overflow-x-auto tf:rounded-b-xl tf:border tf:p-3.5 tf:text-tf-label tf:leading-relaxed", children: _jsx("code", { className: "tf:font-mono", children: code }) })) : (_jsx("div", { "data-tf-code-html": "", className: "tf:overflow-x-auto tf:rounded-b-xl tf:border tf:p-3.5 tf:font-mono tf:text-tf-label tf:leading-relaxed", dangerouslySetInnerHTML: { __html: highlighted } }))] }));
 }
-//# sourceMappingURL=code-block.js.map

package/dist/components/markdown/highlight.js

@@ -1,22 +1,11 @@
-// The shiki LAZY BOUNDARY: the only door to the highlighter. Code blocks
-// render as plain <pre><code> immediately and upgrade to highlighted
-// HTML when (and only when) this dynamic import lands — the grammars and
-// engine never ride the first expand (tests/bundle-weight.test.ts pins
-// that). Module-level cache: one in-flight import serves every block.
 let highlighterModule = null;
 function loadHighlighter() {
     highlighterModule ??= import("./shiki-highlighter.js").catch(() => {
-        // A chunk that fails to load (offline embed, blocked CDN path) is a
-        // styling downgrade, never an error surface: the plain <pre> stands.
         highlighterModule = null;
         return null;
     });
     return highlighterModule;
 }
-/** Highlighted HTML for a fenced block, or null when highlighting is
- *  unavailable (unknown language, chunk failed) — the caller keeps its
- *  plain rendering. The HTML carries `--shiki-*` CSS variables, themed
- *  by styles.css in Graphite ink levels for both modes. */
 export async function highlightToHtml(code, language) {
     const module = await loadHighlighter();
     if (module === null) {
@@ -24,4 +13,3 @@ export async function highlightToHtml(code, language) {
     }
     return module.highlightWithShiki(code, language);
 }
-//# sourceMappingURL=highlight.js.map