@teaflask/assistant 0.0.0 → 0.3.0

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

@@ -0,0 +1,60 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Fragment, useContext, useEffect, useRef, useState, } from "react";
+import { ElicitationsContext } from "./elicitation-context.js";
+import { TfButton } from "./primitives/button.js";
+import { Spinner } from "./streaming-states.js";
+/** The footer's three states: sending, the discard confirm, or the
+ *  actions (the gate's reason, Cancel, and the one continue). */
+export function QuestionPanelFooter({ card, cursor, gateReason, disabled, submitGated, onProceed, }) {
+    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
+                        ? total === 1
+                            ? "Submit answer"
+                            : "Submit answers"
+                        : "Next question" })] }, "actions")) }));
+}
+// The Cancel confirm: entering and leaving it hands focus to the control
+// that replaced the one under the pointer.
+function useCancelConfirm(card) {
+    const { drafts, cancelQuestionSet } = useContext(ElicitationsContext);
+    const [confirming, setConfirming] = useState(false);
+    const cancelRef = useRef(null);
+    const keepEditingRef = useRef(null);
+    const wasConfirmingRef = useRef(false);
+    // The Cancel confirm swaps the footer's controls out from under the
+    // pointer and the keyboard alike; hand focus to the control that took
+    // the place (Keep editing on the way in, Cancel on the way back) so a
+    // keyboard member never lands on <body>.
+    useEffect(() => {
+        if (confirming) {
+            keepEditingRef.current?.focus();
+        }
+        else if (wasConfirmingRef.current) {
+            cancelRef.current?.focus();
+        }
+        wasConfirmingRef.current = confirming;
+    }, [confirming]);
+    return {
+        confirming,
+        cancelRef,
+        keepEditingRef,
+        requestCancel: () => {
+            if (drafts.hasContent(card.interruptId)) {
+                setConfirming(true);
+                return;
+            }
+            void cancelQuestionSet(card);
+        },
+        keepEditing: () => {
+            setConfirming(false);
+        },
+        discard: () => {
+            setConfirming(false);
+            void cancelQuestionSet(card);
+        },
+    };
+}
+//# sourceMappingURL=question-panel-footer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"question-panel-footer.js","sourceRoot":"","sources":["../../src/components/question-panel-footer.tsx"],"names":[],"mappings":"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"}

package/dist/components/question-panel.d.ts

@@ -0,0 +1,5 @@
+import type { QuestionSetCardModel } from "../core/elicitation-cards.js";
+export declare function QuestionPanel({ card }: {
+    card: QuestionSetCardModel;
+}): import("react").JSX.Element;
+//# sourceMappingURL=question-panel.d.ts.map

package/dist/components/question-panel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"question-panel.d.ts","sourceRoot":"","sources":["../../src/components/question-panel.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAsDzE,wBAAgB,aAAa,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,oBAAoB,CAAA;CAAE,+BAKrE"}

package/dist/components/question-panel.js

@@ -0,0 +1,144 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { ChevronLeftIcon, ChevronRightIcon } from "lucide-react";
+import { useContext, useId, useState, useSyncExternalStore } from "react";
+import { answersOf, firstUnansweredIndexOf, MAX_ANSWER_TEXT_CHARS, overLimitOf, } from "../core/question-drafts.js";
+import { ElicitationsContext } from "./elicitation-context.js";
+import { settledQuestionsReceiptOfCard } from "../core/question-receipt.js";
+import { QuestionSetReceiptRow } from "./elicitation-receipt-row.js";
+import { TfButton } from "./primitives/button.js";
+import { QuestionPanelAnswers, } from "./question-panel-answers.js";
+import { QuestionPanelFooter } from "./question-panel-footer.js";
+import { useAnswerListFold } from "./use-answer-list-fold.js";
+import { useQuestionPanelKeys } from "./use-question-panel-keys.js";
+// The question panel: one pending question SET as one surface in the
+// suspension slot. Heading top-left, the pager (‹ n/N ›) top-right, the
+// question, then the suggested answers as full-width numbered rows with a
+// directly editable "Custom answer" row last, and a footer of Cancel +
+// Next question / Submit answers. Navigation is LOCAL — it moves a cursor
+// in the store's draft, never a byte over the wire — and the one Submit
+// posts the whole set at once. Every draft (choice, custom text, cursor)
+// lives in the store's QuestionDraftStore, so the pager's keyed remount, a
+// reconnect and a workflow restart all return the member to exactly where
+// they were.
+//
+// The active choice is explicit — a suggestion OR the custom row. Picking
+// a suggestion keeps the custom text (the member may return to it);
+// typing in the custom row makes it active, and reaching the custom row
+// by pointer or arrow re-activates it only once it holds an answer (the
+// table beside activateCustomIfDrafted). Nothing is ever judged about
+// the text: Submit is gated only on "every question has an answer" and
+// the transport bound, and the answer posted is the suggestion's visible
+// text or the member's words verbatim. While Submit is gated the footer
+// names the first unanswered question, and a continue from the last
+// question jumps there instead of doing nothing.
+// The settled forms, on the panel itself (the meta-receipt rule: a settled
+// decision's surfaces are the card's own footer and the operation row's
+// state, never transcript prose). Module-private: an expired set keeps
+// its heading with controls gone and one muted sentence; a set the
+// member dismissed, the same shape with the dismissed sentence — stated
+// once, never a failure. Both render only where the panel mounts inline
+// (shelf-less hosts); in the shipping shelf composition a settled set
+// leaves the slot (TVC-064).
+const STALE_NOTE = "These questions were already answered or expired.";
+const CANCELLED_NOTE = "The assistant's questions were dismissed.";
+export function QuestionPanel({ card }) {
+    if (card.status === "answered" || card.status === "stale") {
+        return _jsx(SettledQuestionPanel, { card: card });
+    }
+    return _jsx(PendingQuestionPanel, { card: card });
+}
+/** The settled set where the panel stood: the Q→A receipt (this tab's
+ *  own answers, or the plain answered fact per question when another
+ *  client answered), or the heading over one muted sentence for a
+ *  dismissed or expired set. */
+function SettledQuestionPanel({ card }) {
+    if (card.status === "answered") {
+        const receipt = settledQuestionsReceiptOfCard(card.questions, card.answered);
+        if (receipt !== null) {
+            return _jsx(QuestionSetReceiptRow, { receipt: receipt });
+        }
+    }
+    return (_jsxs("div", { "data-tf-elicitation-card": "", "data-tf-question-panel": "", "data-tf-question-panel-settled": card.status === "stale" ? "stale" : "cancelled", role: "group", "aria-label": "The assistant asked questions", className: "tf:my-1 tf:rounded-xl tf:border tf:p-4", children: [_jsx("p", { className: "tf:min-w-0 tf:truncate tf:text-tf-label tf:text-tf-muted-foreground", "data-tf-question-heading": "", children: card.questions[0].heading }), _jsx("p", { className: "tf:mt-2 tf:text-tf-label tf:text-tf-muted-foreground", children: card.status === "stale" ? STALE_NOTE : CANCELLED_NOTE })] }));
+}
+function PendingQuestionPanel({ card }) {
+    const { drafts, submitQuestionAnswers } = useContext(ElicitationsContext);
+    const draft = useSyncExternalStore(drafts.subscribe, () => drafts.get(card.interruptId), () => drafts.get(card.interruptId));
+    const total = card.questions.length;
+    const cursor = Math.min(Math.max(draft.cursor, 0), total - 1);
+    const question = card.questions[cursor];
+    const answerDraft = draft.answers.get(question.id);
+    const active = answerDraft?.active ?? null;
+    const customText = answerDraft?.customText ?? "";
+    const answerable = card.status === "actionable";
+    const ids = {
+        hint: useId(),
+        prompt: useId(),
+        descriptionBase: useId(),
+        custom: useId(),
+    };
+    const [openDescription, setOpenDescription] = useState(null);
+    const { rowsRef, customRef, goTo, proceed, selectOption, activateCustomIfDrafted, setCustomText, optionKeys, customKeys, } = useQuestionPanelKeys({
+        card,
+        drafts,
+        submitQuestionAnswers,
+        cursor,
+        question,
+        active,
+        customText,
+        answerable,
+        closeDescription: () => {
+            setOpenDescription(null);
+        },
+    });
+    const { answersRef, foldBelow, declareFold } = useAnswerListFold(cursor, openDescription, customText);
+    const gate = submitGateOf(card.questions, draft, cursor, customText);
+    // The one announced fact: the question under the member's hands first
+    // (its own over-limit sentence), else the Submit gate's reason.
+    const statusSentence = gate.overLimitSentence ?? gate.gateReason ?? "";
+    return (_jsxs("div", { "data-tf-elicitation-card": "", "data-tf-question-panel": "", role: "group", "aria-label": "The assistant asked questions", className: "tf:my-1 tf:rounded-xl tf:border tf:p-4", children: [_jsx(QuestionPanelHeader, { card: card, cursor: cursor, goTo: goTo }), _jsx(QuestionPanelPrompt, { card: card, question: question, ids: ids }), _jsx("span", { role: "status", className: "tf:sr-only", "data-tf-question-status": "", children: statusSentence }), _jsx(QuestionPanelAnswers, { question: question, active: active, customText: customText, disabled: !answerable, ids: ids, openDescription: openDescription, onToggleDescription: setOpenDescription, overLimitSentence: gate.overLimitSentence, answersRef: answersRef, foldBelow: foldBelow, onScroll: declareFold, rowsRef: rowsRef, customRef: customRef, selectOption: selectOption, activateCustomIfDrafted: activateCustomIfDrafted, setCustomText: setCustomText, optionKeys: optionKeys, customKeys: customKeys }), _jsx(QuestionPanelFooter, { card: card, cursor: cursor, gateReason: gate.gateReason, disabled: !answerable, submitGated: gate.submitGated, onProceed: proceed })] }));
+}
+/** Heading top-left, the pager (‹ n/N ›) top-right — the pager only
+ *  when the set has more than one question. */
+function QuestionPanelHeader({ card, cursor, goTo, }) {
+    const total = card.questions.length;
+    return (_jsxs("div", { className: "tf:flex tf:items-center tf:justify-between tf:gap-3", children: [_jsx("p", { className: "tf:min-w-0 tf:truncate tf:text-tf-label tf:text-tf-muted-foreground", "data-tf-question-heading": "", children: card.questions[cursor].heading }), total > 1 ? (_jsxs("div", { className: "tf:flex tf:shrink-0 tf:items-center tf:gap-1", "data-tf-question-pager": "", children: [_jsx(TfButton, { variant: "icon", "aria-label": "Previous question", disabled: cursor === 0, onClick: () => {
+                            goTo(cursor - 1);
+                        }, children: _jsx(ChevronLeftIcon, { "aria-hidden": true, className: "tf:size-4" }) }), _jsx("span", { className: "tf:text-tf-label tf:tabular-nums tf:text-tf-muted-foreground", children: `${String(cursor + 1)}/${String(total)}` }), _jsx(TfButton, { variant: "icon", "aria-label": "Next question", disabled: cursor === total - 1, onClick: () => {
+                            goTo(cursor + 1);
+                        }, children: _jsx(ChevronRightIcon, { "aria-hidden": true, className: "tf:size-4" }) })] })) : null] }));
+}
+/** The question, the parked note and the error alert when the card
+ *  carries them, and the screen-reader-only keyboard hint. */
+function QuestionPanelPrompt({ card, question, ids, }) {
+    return (_jsxs(_Fragment, { children: [_jsx("p", { id: ids.prompt, className: "tf:mt-1 tf:text-tf-heading tf:font-medium tf:text-tf-foreground", "data-tf-question-prompt": "", children: question.prompt }), card.errorSentence !== null ? (_jsx("p", { role: "alert", className: "tf:mt-2 tf:text-tf-label tf:text-tf-destructive", children: card.errorSentence })) : null, _jsx("p", { id: ids.hint, className: "tf:sr-only", children: "Use the up and down arrow keys to choose a suggested answer and Enter to continue. In the custom answer, Enter adds a line and Command or Control with Enter continues." })] }));
+}
+// EVERY gate names its reason: an over-bound custom
+// answer — possibly two questions back — outranks an unanswered one,
+// because it is the harder gap to find.
+function submitGateOf(questions, draft, cursor, customText) {
+    const answers = answersOf(questions, draft);
+    const firstUnanswered = firstUnansweredIndexOf(questions, draft);
+    const overLimit = overLimitOf(questions, draft, MAX_ANSWER_TEXT_CHARS);
+    const isLast = cursor === questions.length - 1;
+    const currentOverLimit = overLimit.includes(questions[cursor].id);
+    const submitGated = isLast && (answers === null || overLimit.length > 0);
+    const firstOverLimit = overLimit.length > 0
+        ? questions.findIndex((entry) => entry.id === overLimit[0])
+        : -1;
+    // Every count the member reads is pinned to en-US digits and grouping
+    // (tool-arguments-summary's rule): the widget embeds in arbitrary
+    // host pages, and a host locale must not reshape "1,900".
+    const gateReason = !isLast
+        ? null
+        : firstOverLimit >= 0
+            ? `Question ${String(firstOverLimit + 1)}'s custom answer is over ${MAX_ANSWER_TEXT_CHARS.toLocaleString("en-US")} characters`
+            : answers === null && firstUnanswered >= 0
+                ? `Question ${String(firstUnanswered + 1)} needs an answer`
+                : null;
+    const overLimitSentence = currentOverLimit
+        ? `Custom answers are limited to ${MAX_ANSWER_TEXT_CHARS.toLocaleString("en-US")} characters (this one is ${customText.length.toLocaleString("en-US")}).`
+        : null;
+    return { submitGated, gateReason, overLimitSentence };
+}
+//# sourceMappingURL=question-panel.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"question-panel.js","sourceRoot":"","sources":["../../src/components/question-panel.tsx"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,19 @@
+import { type ComponentType } from "react";
+import type { ToolViewAdapter, ToolViewProps } from "../core/tool-view.js";
+/** Wrap a React component as a canonical tool-view adapter. Also the
+ *  icon spelling — IconAdapter shares the lifecycle, so the same
+ *  wrapper serves `{ version, icon: reactToolView(MyMark) }`. Generic
+ *  like the adapter it produces: a component written against generated
+ *  per-org argument types (`ToolViewProps<MyArgs>`) wraps without a
+ *  cast, and the typed adapter assigns to the registration through
+ *  method bivariance (core/tool-view.ts). */
+export declare function reactToolView<TArgs = Record<string, unknown>, TResult = unknown>(component: ComponentType<ToolViewProps<TArgs, TResult>>): ToolViewAdapter<TArgs, TResult>;
+/** The package-internal late-failure channel between the React sugar
+ *  and the mount slot: a passive-effect throw cannot surface as a
+ *  synchronous mount/update throw, so the sugar dispatches it on the
+ *  mount container — the one object both sides share — and the slot
+ *  treats it exactly like a thrown adapter (report, clear, advance).
+ *  Not part of the public adapter contract: a vanilla adapter's own
+ *  async failures remain the adapter's to handle. */
+export declare const TOOL_VIEW_LATE_FAILURE_EVENT = "teaflask-tool-view-late-failure";
+//# sourceMappingURL=react-tool-view.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"react-tool-view.d.ts","sourceRoot":"","sources":["../../src/components/react-tool-view.tsx"],"names":[],"mappings":"AASA,OAAO,EAAa,KAAK,aAAa,EAAkB,MAAM,OAAO,CAAC;AAItE,OAAO,KAAK,EACV,eAAe,EAEf,aAAa,EACd,MAAM,sBAAsB,CAAC;AAE9B;;;;;;6CAM6C;AAC7C,wBAAgB,aAAa,CAC3B,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,GAAG,OAAO,EAEjB,SAAS,EAAE,aAAa,CAAC,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,GACtD,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,CAsFjC;AAED;;;;;;qDAMqD;AACrD,eAAO,MAAM,4BAA4B,oCAAoC,CAAC"}

package/dist/components/react-tool-view.js

@@ -0,0 +1,132 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+// The React spelling of the tool-view contract: thin sugar over the
+// imperative {mount → {update, destroy}} lifecycle — one contract, two
+// spellings, never two systems (tool-views.md). The component renders
+// into its own react-dom root inside the package-owned container;
+// `update` re-renders the same element type, so React reconciles and
+// component-local state survives a status advance; `destroy` unmounts.
+import { Component } from "react";
+import { flushSync } from "react-dom";
+import { createRoot } from "react-dom/client";
+/** Wrap a React component as a canonical tool-view adapter. Also the
+ *  icon spelling — IconAdapter shares the lifecycle, so the same
+ *  wrapper serves `{ version, icon: reactToolView(MyMark) }`. Generic
+ *  like the adapter it produces: a component written against generated
+ *  per-org argument types (`ToolViewProps<MyArgs>`) wraps without a
+ *  cast, and the typed adapter assigns to the registration through
+ *  method bivariance (core/tool-view.ts). */
+export function reactToolView(component) {
+    const View = component;
+    return {
+        mount(container, props) {
+            const root = createRoot(container);
+            // PREMISE — which throw phases the latch can observe inside the
+            // flushSync window, and which it cannot (settled empirically, r3):
+            // render, layout-effect AND passive-effect throws belonging to a
+            // renderInto flush all surface before flushSync returns — React
+            // flushes the forced work's passive effects synchronously — so
+            // renderInto rethrows them all: the adapter contract's one
+            // failure channel. What no mount/update return can ever observe
+            // is a throw from a render the view schedules for ITSELF — its
+            // own setState from a timer, a promise, a subscription —
+            // committed by the nested root with no renderInto in flight.
+            // componentDidCatch then fires with the window closed, and the
+            // failure travels the container's late-failure event instead —
+            // the mount slot listens and advances the ladder, restoring the
+            // replaced React boundary's any-phase fallback-and-report
+            // behaviour across the imperative seam.
+            let unmounted = false;
+            const unmountLate = () => {
+                if (!unmounted) {
+                    unmounted = true;
+                    // Asynchronously: react-dom forbids unmounting while its own
+                    // commit or effect flush is still on the stack.
+                    queueMicrotask(() => {
+                        root.unmount();
+                    });
+                }
+            };
+            const latch = {
+                inSyncWindow: false,
+                failed: false,
+                error: undefined,
+                onLateFailure: (error) => {
+                    unmountLate();
+                    container.dispatchEvent(new CustomEvent(TOOL_VIEW_LATE_FAILURE_EVENT, { detail: error }));
+                },
+            };
+            const renderInto = (next) => {
+                // Read through a local: componentDidCatch mutates the latch from
+                // inside the flushSync call below, which control-flow narrowing
+                // cannot see — narrowing the property itself would mis-read the
+                // post-flush check as always-false.
+                const alreadyFailed = latch.failed;
+                if (alreadyFailed) {
+                    // Already failed and reported (sync throw or late event); the
+                    // slot never reuses a failed instance, so a straggling update
+                    // is a no-op rather than a stale re-throw and double report.
+                    return;
+                }
+                latch.inSyncWindow = true;
+                try {
+                    flushSync(() => {
+                        root.render(_jsx(_CatchBoundary, { latch: latch, children: _jsx(View, { ...next }) }));
+                    });
+                }
+                finally {
+                    latch.inSyncWindow = false;
+                }
+                if (latch.failed) {
+                    unmountLate();
+                    throw latch.error;
+                }
+            };
+            renderInto(props);
+            return {
+                update: renderInto,
+                destroy: () => {
+                    if (!unmounted) {
+                        unmounted = true;
+                        root.unmount();
+                    }
+                },
+            };
+        },
+    };
+}
+/** The package-internal late-failure channel between the React sugar
+ *  and the mount slot: a passive-effect throw cannot surface as a
+ *  synchronous mount/update throw, so the sugar dispatches it on the
+ *  mount container — the one object both sides share — and the slot
+ *  treats it exactly like a thrown adapter (report, clear, advance).
+ *  Not part of the public adapter contract: a vanilla adapter's own
+ *  async failures remain the adapter's to handle. */
+export const TOOL_VIEW_LATE_FAILURE_EVENT = "teaflask-tool-view-late-failure";
+/** Records a child throw into the mount's latch. Inside the flushSync
+ *  window the wrapper above rethrows on the adapter's stack; outside it
+ *  (a passive-effect throw) the latch's late channel carries it.
+ *  Latching — a component that threw never flickers back in on a later
+ *  commit of the same root. */
+class _CatchBoundary extends Component {
+    state = { failed: false };
+    static getDerivedStateFromError() {
+        return { failed: true };
+    }
+    componentDidCatch(error) {
+        const latch = this.props.latch;
+        const alreadyFailed = latch.failed;
+        latch.failed = true;
+        latch.error = error;
+        if (!latch.inSyncWindow && !alreadyFailed) {
+            latch.onLateFailure(error);
+        }
+    }
+    render() {
+        if (this.state.failed) {
+            return null;
+        }
+        return this.props.children;
+    }
+}
+//# sourceMappingURL=react-tool-view.js.map

package/dist/components/react-tool-view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-tool-view.js","sourceRoot":"","sources":["../../src/components/react-tool-view.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,oEAAoE;AACpE,uEAAuE;AACvE,sEAAsE;AACtE,kEAAkE;AAClE,qEAAqE;AACrE,uEAAuE;AAEvE,OAAO,EAAE,SAAS,EAAsC,MAAM,OAAO,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAQ9C;;;;;;6CAM6C;AAC7C,MAAM,UAAU,aAAa,CAI3B,SAAuD;IAEvD,MAAM,IAAI,GAAG,SAAS,CAAC;IACvB,OAAO;QACL,KAAK,CACH,SAAsB,EACtB,KAAoC;YAEpC,MAAM,IAAI,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;YACnC,gEAAgE;YAChE,mEAAmE;YACnE,iEAAiE;YACjE,gEAAgE;YAChE,+DAA+D;YAC/D,2DAA2D;YAC3D,gEAAgE;YAChE,+DAA+D;YAC/D,yDAAyD;YACzD,6DAA6D;YAC7D,+DAA+D;YAC/D,+DAA+D;YAC/D,gEAAgE;YAChE,0DAA0D;YAC1D,wCAAwC;YACxC,IAAI,SAAS,GAAG,KAAK,CAAC;YACtB,MAAM,WAAW,GAAG,GAAG,EAAE;gBACvB,IAAI,CAAC,SAAS,EAAE,CAAC;oBACf,SAAS,GAAG,IAAI,CAAC;oBACjB,6DAA6D;oBAC7D,gDAAgD;oBAChD,cAAc,CAAC,GAAG,EAAE;wBAClB,IAAI,CAAC,OAAO,EAAE,CAAC;oBACjB,CAAC,CAAC,CAAC;gBACL,CAAC;YACH,CAAC,CAAC;YACF,MAAM,KAAK,GAAkB;gBAC3B,YAAY,EAAE,KAAK;gBACnB,MAAM,EAAE,KAAK;gBACb,KAAK,EAAE,SAAS;gBAChB,aAAa,EAAE,CAAC,KAAK,EAAE,EAAE;oBACvB,WAAW,EAAE,CAAC;oBACd,SAAS,CAAC,aAAa,CACrB,IAAI,WAAW,CAAC,4BAA4B,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CACjE,CAAC;gBACJ,CAAC;aACF,CAAC;YACF,MAAM,UAAU,GAAG,CAAC,IAAmC,EAAE,EAAE;gBACzD,iEAAiE;gBACjE,gEAAgE;gBAChE,gEAAgE;gBAChE,oCAAoC;gBACpC,MAAM,aAAa,GAAY,KAAK,CAAC,MAAM,CAAC;gBAC5C,IAAI,aAAa,EAAE,CAAC;oBAClB,8DAA8D;oBAC9D,8DAA8D;oBAC9D,6DAA6D;oBAC7D,OAAO;gBACT,CAAC;gBACD,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC;gBAC1B,IAAI,CAAC;oBACH,SAAS,CAAC,GAAG,EAAE;wBACb,IAAI,CAAC,MAAM,CACT,KAAC,cAAc,IAAC,KAAK,EAAE,KAAK,YAC1B,KAAC,IAAI,OAAK,IAAI,GAAI,GACH,CAClB,CAAC;oBACJ,CAAC,CAAC,CAAC;gBACL,CAAC;wBAAS,CAAC;oBACT,KAAK,CAAC,YAAY,GAAG,KAAK,CAAC;gBAC7B,CAAC;gBACD,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;oBACjB,WAAW,EAAE,CAAC;oBACd,MAAM,KAAK,CAAC,KAAK,CAAC;gBACpB,CAAC;YACH,CAAC,CAAC;YACF,UAAU,CAAC,KAAK,CAAC,CAAC;YAClB,OAAO;gBACL,MAAM,EAAE,UAAU;gBAClB,OAAO,EAAE,GAAG,EAAE;oBACZ,IAAI,CAAC,SAAS,EAAE,CAAC;wBACf,SAAS,GAAG,IAAI,CAAC;wBACjB,IAAI,CAAC,OAAO,EAAE,CAAC;oBACjB,CAAC;gBACH,CAAC;aACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;;qDAMqD;AACrD,MAAM,CAAC,MAAM,4BAA4B,GAAG,iCAAiC,CAAC;AAS9E;;;;+BAI+B;AAC/B,MAAM,cAAe,SAAQ,SAG5B;IACC,KAAK,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAE1B,MAAM,CAAC,wBAAwB;QAC7B,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAC1B,CAAC;IAED,iBAAiB,CAAC,KAAY;QAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;QAC/B,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC;QACnC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;QACpB,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,KAAK,CAAC,YAAY,IAAI,CAAC,aAAa,EAAE,CAAC;YAC1C,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,MAAM;QACJ,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;IAC7B,CAAC;CACF"}

package/dist/components/reasoning-row.d.ts

@@ -0,0 +1,5 @@
+import type { ReasoningRow as ReasoningRowModel } from "../core/transcript-rows.js";
+export declare function ReasoningRow({ view }: {
+    view: ReasoningRowModel;
+}): import("react").JSX.Element;
+//# sourceMappingURL=reasoning-row.d.ts.map

package/dist/components/reasoning-row.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasoning-row.d.ts","sourceRoot":"","sources":["../../src/components/reasoning-row.tsx"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,YAAY,IAAI,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAOpF,wBAAgB,YAAY,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,iBAAiB,CAAA;CAAE,+BA4CjE"}

package/dist/components/reasoning-row.js

@@ -0,0 +1,22 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+// The adopted register — assistant-ui `reasoning` as the visual reference:
+// the model's native reasoning as a quiet collapsible line above the
+// answer. While the reasoning streams the line reads "Thinking…" under
+// the moving gradient and the body holds itself open so the thought reads
+// as it arrives; once the answer starts it collapses to a static
+// "Thought about it". No duration on the label: the run events carry no
+// timestamps, and a client-side clock would lie on every replay.
+import { LightbulbIcon } from "lucide-react";
+import { REASONING_SETTLED_LABEL, REASONING_STREAMING_LABEL, } from "../core/reasoning-copy.js";
+import { Disclosure, DisclosureChevron } from "./primitives/disclosure.js";
+import { ShimmerText } from "./streaming-states.js";
+// One form only: every reasoning row lives on an activity rail (the
+// grouping in use-transcript-folds.ts folds all reasoning into a group), so the
+// rail geometry — leading state mark, gap-3, ps-7 body — IS the row.
+export function ReasoningRow({ view }) {
+    return (_jsx(Disclosure, { variant: "bare", open: view.streaming || undefined, className: "tf:w-full", summaryClassName: "tf:flex tf:w-fit tf:items-center tf:gap-3 tf:py-1.5 tf:text-tf-label tf:text-tf-muted-foreground tf:hover:text-tf-foreground", bodyClassName: "tf:ps-7 tf:pt-1 tf:pb-2", summary: _jsxs(_Fragment, { children: [_jsxs("span", { "data-tf-reasoning-mark": "", className: view.streaming
+                        ? "tf:grid tf:size-4 tf:shrink-0 tf:place-items-center tf:opacity-45"
+                        : "tf:grid tf:size-4 tf:shrink-0 tf:place-items-center", children: [_jsx(LightbulbIcon, { "aria-hidden": true, className: "tf:size-4" }), _jsx("span", { className: "tf:sr-only", children: view.streaming ? "Thinking" : "Thought" })] }), view.streaming ? (_jsx(ShimmerText, { className: "tf:leading-none", children: REASONING_STREAMING_LABEL })) : (_jsx("span", { className: "tf:leading-none", children: REASONING_SETTLED_LABEL })), _jsx(DisclosureChevron, { revealOnInteraction: true })] }), children: _jsx("p", { className: "tf:text-tf-label tf:whitespace-pre-wrap tf:text-tf-muted-foreground", children: view.text }) }));
+}
+//# sourceMappingURL=reasoning-row.js.map

package/dist/components/reasoning-row.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasoning-row.js","sourceRoot":"","sources":["../../src/components/reasoning-row.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,2EAA2E;AAC3E,qEAAqE;AACrE,uEAAuE;AACvE,0EAA0E;AAC1E,iEAAiE;AACjE,wEAAwE;AACxE,iEAAiE;AAEjE,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,OAAO,EACL,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,oEAAoE;AACpE,gFAAgF;AAChF,qEAAqE;AACrE,MAAM,UAAU,YAAY,CAAC,EAAE,IAAI,EAA+B;IAChE,OAAO,CACL,KAAC,UAAU,IACT,OAAO,EAAC,MAAM,EACd,IAAI,EAAE,IAAI,CAAC,SAAS,IAAI,SAAS,EACjC,SAAS,EAAC,WAAW,EACrB,gBAAgB,EAAC,8HAA8H,EAC/I,aAAa,EAAC,yBAAyB,EACvC,OAAO,EACL,8BACE,0CAMyB,EAAE,EACzB,SAAS,EACP,IAAI,CAAC,SAAS;wBACZ,CAAC,CAAC,mEAAmE;wBACrE,CAAC,CAAC,qDAAqD,aAG3D,KAAC,aAAa,yBAAa,SAAS,EAAC,WAAW,GAAG,EACnD,eAAM,SAAS,EAAC,YAAY,YACzB,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,GACnC,IACF,EACN,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAChB,KAAC,WAAW,IAAC,SAAS,EAAC,iBAAiB,YACrC,yBAAyB,GACd,CACf,CAAC,CAAC,CAAC,CACF,eAAM,SAAS,EAAC,iBAAiB,YAAE,uBAAuB,GAAQ,CACnE,EACD,KAAC,iBAAiB,IAAC,mBAAmB,SAAG,IACxC,YAGL,YAAG,SAAS,EAAC,qEAAqE,YAC/E,IAAI,CAAC,IAAI,GACR,GACO,CACd,CAAC;AACJ,CAAC"}

package/dist/components/receipt-rows.d.ts

@@ -0,0 +1,4 @@
+export declare function TurnFailedReceiptRows({ receipts, }: {
+    receipts: readonly string[];
+}): import("react").JSX.Element;
+//# sourceMappingURL=receipt-rows.d.ts.map

package/dist/components/receipt-rows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"receipt-rows.d.ts","sourceRoot":"","sources":["../../src/components/receipt-rows.tsx"],"names":[],"mappings":"AAuBA,wBAAgB,qBAAqB,CAAC,EACpC,QAAQ,GACT,EAAE;IACD,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B,+BAmBA"}

package/dist/components/receipt-rows.js

@@ -0,0 +1,25 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { CircleAlertIcon } from "lucide-react";
+// The turn-level failure receipt — the ONE standalone receipt row left
+// after the meta-receipt class was deleted: a turn that dies mid-way
+// otherwise stops with no answer and no explanation. Its quiet
+// siblings (the turn_voided stamp rows, the approval/decline settled
+// statements, the resume divider) no longer render at all; their
+// markers stay on the wire and in the store, but the transcript carries
+// no narration for them. A member's own stop (turn_stopped) projects no
+// row either; the paired quiet RUN_FINISHED — not any marker — is what
+// closes a pause's cards and settles the composer.
+// The turn-level terminal failure receipt: a turn that ended failed
+// outside any single tool, rendered where the answer broke off —
+// explicit and calm, never an assistant-voiced paragraph and never a
+// detached banner. Deliberately distinct from an operation-level
+// failure, which is an in-row pill on the affected tool row. The glyph
+// shape plus the sentence are the non-colour signal; the sentence
+// itself is the wire's reader-aware copy, so the row exposes exactly
+// the safe detail the REST wire already serves. Zero motion — a failed
+// turn never leaves anything spinning.
+export function TurnFailedReceiptRows({ receipts, }) {
+    return (_jsx("div", { className: "tf:flex tf:flex-col tf:gap-1 tf:py-1", children: receipts.map((receipt, index) => (_jsxs("p", { "data-tf-turn-failed-receipt": "", className: "tf:flex tf:items-center tf:gap-2 tf:text-xs tf:text-tf-muted-foreground", children: [_jsx(CircleAlertIcon, { "aria-hidden": true, className: "tf:size-3.5 tf:shrink-0 tf:text-tf-destructive" }), _jsx("span", { className: "tf:sr-only", children: "Turn failed:" }), _jsx("span", { className: "tf:min-w-0", children: receipt })] }, `${receipt}-${String(index)}`))) }));
+}
+//# sourceMappingURL=receipt-rows.js.map

package/dist/components/receipt-rows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"receipt-rows.js","sourceRoot":"","sources":["../../src/components/receipt-rows.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,uEAAuE;AACvE,qEAAqE;AACrE,+DAA+D;AAC/D,qEAAqE;AACrE,iEAAiE;AACjE,wEAAwE;AACxE,wEAAwE;AACxE,uEAAuE;AACvE,mDAAmD;AAEnD,oEAAoE;AACpE,iEAAiE;AACjE,qEAAqE;AACrE,iEAAiE;AACjE,uEAAuE;AACvE,kEAAkE;AAClE,qEAAqE;AACrE,uEAAuE;AACvE,uCAAuC;AACvC,MAAM,UAAU,qBAAqB,CAAC,EACpC,QAAQ,GAGT;IACC,OAAO,CACL,cAAK,SAAS,EAAC,sCAAsC,YAClD,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,CAChC,4CAE8B,EAAE,EAC9B,SAAS,EAAC,yEAAyE,aAEnF,KAAC,eAAe,yBAEd,SAAS,EAAC,gDAAgD,GAC1D,EACF,eAAM,SAAS,EAAC,YAAY,6BAAoB,EAChD,eAAM,SAAS,EAAC,YAAY,YAAE,OAAO,GAAQ,KATxC,GAAG,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAUhC,CACL,CAAC,GACE,CACP,CAAC;AACJ,CAAC"}

package/dist/components/run-status-announcer.d.ts

@@ -0,0 +1,9 @@
+import type { TurnStatus } from "../contract/threads.js";
+export declare function RunStatusAnnouncer({ status, decisionsPending, }: {
+    status: TurnStatus | null;
+    /** True while a member-actionable decision is live (the suspension
+     *  slot's own predicates — approvals awaiting the member, questions
+     *  still collecting). Never inferred from what rendered. */
+    decisionsPending: boolean;
+}): import("react").JSX.Element;
+//# sourceMappingURL=run-status-announcer.d.ts.map

package/dist/components/run-status-announcer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-status-announcer.d.ts","sourceRoot":"","sources":["../../src/components/run-status-announcer.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAwBzD,wBAAgB,kBAAkB,CAAC,EACjC,MAAM,EACN,gBAAgB,GACjB,EAAE;IACD,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;IAC1B;;gEAE4D;IAC5D,gBAAgB,EAAE,OAAO,CAAC;CAC3B,+BAWA"}

package/dist/components/run-status-announcer.js

@@ -0,0 +1,34 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { announcedStatusOf } from "../core/run-status.js";
+// The transcript's status live region. The conversation chrome makes no
+// visible run-state claims — the shelf's status line was deleted (its
+// work-in-progress story belongs to the subagent pill, the fold's own
+// "Working…" content headline, and the Stop control; its waiting story
+// belongs to the decision surface itself) — but a screen reader still
+// needs the transitions the visuals no longer spell out. Rules carried
+// over from the line it replaces:
+//
+// - Mounted UNCONDITIONALLY (an empty sr-only span while idle): screen
+//   readers announce MUTATIONS of an existing live region, and generally
+//   skip a node that arrives already carrying role="status" and its
+//   text — so the element must pre-exist every phrase change. sr-only is
+//   absolutely positioned, so it costs the region no layout height, and
+//   it lives OUTSIDE the shelf's slots so a permanent occupant cannot
+//   defeat their :empty collapse.
+// - Throttled by construction: the phrase changes only on status-class
+//   transitions (idle ↔ working ↔ waiting), never per streamed token and
+//   never per elapsed second.
+// - Honest about who is waited on: "Waiting for your input" is claimed
+//   only while an actionable decision surface exists — a pause with no
+//   pending decision (a subagent park, the execution driver's window)
+//   announces the machine's time, "The assistant is working".
+export function RunStatusAnnouncer({ status, decisionsPending, }) {
+    const state = announcedStatusOf(status, decisionsPending);
+    return (_jsx("span", { "data-tf-status-announcer": "", role: "status", className: "tf:sr-only", children: state === "waiting"
+            ? "Waiting for your input"
+            : state === null
+                ? ""
+                : "The assistant is working" }));
+}
+//# sourceMappingURL=run-status-announcer.js.map

package/dist/components/run-status-announcer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-status-announcer.js","sourceRoot":"","sources":["../../src/components/run-status-announcer.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAG1D,wEAAwE;AACxE,sEAAsE;AACtE,sEAAsE;AACtE,uEAAuE;AACvE,sEAAsE;AACtE,uEAAuE;AACvE,kCAAkC;AAClC,EAAE;AACF,uEAAuE;AACvE,yEAAyE;AACzE,oEAAoE;AACpE,yEAAyE;AACzE,wEAAwE;AACxE,sEAAsE;AACtE,kCAAkC;AAClC,uEAAuE;AACvE,yEAAyE;AACzE,8BAA8B;AAC9B,uEAAuE;AACvE,uEAAuE;AACvE,sEAAsE;AACtE,8DAA8D;AAC9D,MAAM,UAAU,kBAAkB,CAAC,EACjC,MAAM,EACN,gBAAgB,GAOjB;IACC,MAAM,KAAK,GAAG,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC1D,OAAO,CACL,2CAA+B,EAAE,EAAC,IAAI,EAAC,QAAQ,EAAC,SAAS,EAAC,YAAY,YACnE,KAAK,KAAK,SAAS;YAClB,CAAC,CAAC,wBAAwB;YAC1B,CAAC,CAAC,KAAK,KAAK,IAAI;gBACd,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,0BAA0B,GAC3B,CACR,CAAC;AACJ,CAAC"}

package/dist/components/scroll-follow-guards.d.ts

@@ -0,0 +1,2 @@
+export declare function ScrollFollowGuards(): null;
+//# sourceMappingURL=scroll-follow-guards.d.ts.map

package/dist/components/scroll-follow-guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll-follow-guards.d.ts","sourceRoot":"","sources":["../../src/components/scroll-follow-guards.tsx"],"names":[],"mappings":"AAsBA,wBAAgB,kBAAkB,SAyBjC"}