@teaflask/assistant 0.0.0 → 0.3.0

package/dist/components/use-transcript-folds.d.ts

@@ -0,0 +1,34 @@
+import { type ReactNode } from "react";
+import { type FoldedBlock, type FoldedTranscriptRow, type RunFoldMember } from "../core/run-folds.js";
+import type { MarkerBoundaries } from "../core/transcript-rows.js";
+import type { MessageListSource } from "./message-list-slots.js";
+export type DisplayRow = FoldedTranscriptRow;
+/** MessageList's per-render derivations, read in one place: the fold
+ *  pass, the hold window, the blocks-mode offsets, the tail receipts and
+ *  the trailing-liveness election. */
+export declare function useMessageListDerivations(source: MessageListSource, { live, typing, turnOpen, markerBoundaries, turnStartIds, decisionSurfacesInShelf, frameClaimsLiveness, emptyFallback, }: {
+    live: boolean;
+    typing: boolean;
+    turnOpen: boolean | undefined;
+    markerBoundaries?: MarkerBoundaries;
+    turnStartIds?: ReadonlySet<string>;
+    decisionSurfacesInShelf: boolean;
+    frameClaimsLiveness: boolean;
+    emptyFallback: ReactNode;
+}): {
+    foldedBlocks: FoldedBlock[] | null;
+    displayRows: readonly FoldedTranscriptRow[];
+    currentTurnStart: number;
+    blockStarts: number[];
+    unrowedAnsweredAsks: import("../headless.js").QuestionSetCardModel[];
+    liveIndex: number;
+    hostEmptySurfaceShown: boolean;
+    livenessClaimant: TrailingLivenessClaimant;
+};
+export type TrailingLivenessClaimant = "tail-row" | "standalone-headline" | "typing-dot" | "none";
+/** One live spelling of "this fold reads as running" — ActivityRail's
+ *  headline and the trailing-liveness arbiter both read it. The trailing
+ *  fold's turnLive bridges the quiet beat between one call's result and
+ *  the next call's start, so back-to-back calls don't blink the headline. */
+export declare function _foldClaimsLiveness(members: readonly RunFoldMember[], turnLive: boolean): boolean;
+//# sourceMappingURL=use-transcript-folds.d.ts.map

package/dist/components/use-transcript-folds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-transcript-folds.d.ts","sourceRoot":"","sources":["../../src/components/use-transcript-folds.ts"],"names":[],"mappings":"AAEA,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAInD,OAAO,EAIL,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACxB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EACV,gBAAgB,EAEjB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAUjE,MAAM,MAAM,UAAU,GAAG,mBAAmB,CAAC;AAE7C;;sCAEsC;AACtC,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,iBAAiB,EACzB,EACE,IAAI,EACJ,MAAM,EACN,QAAQ,EACR,gBAAgB,EAChB,YAAY,EACZ,uBAAuB,EACvB,mBAAmB,EACnB,aAAa,GACd,EAAE;IACD,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,YAAY,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACnC,uBAAuB,EAAE,OAAO,CAAC;IACjC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,aAAa,EAAE,SAAS,CAAC;CAC1B;;;;;;;;;EAmEF;AAkFD,MAAM,MAAM,wBAAwB,GAClC,UAAU,GAAG,qBAAqB,GAAG,YAAY,GAAG,MAAM,CAAC;AA+C7D;;;6EAG6E;AAC7E,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,SAAS,aAAa,EAAE,EACjC,QAAQ,EAAE,OAAO,GAChB,OAAO,CAST"}

package/dist/components/use-transcript-folds.js

@@ -0,0 +1,166 @@
+"use client";
+import { useContext } from "react";
+import { hostFillDeclines } from "../core/host-fill.js";
+import { currentTurnStartOf, foldedBlocksOf, runFoldsOf, } from "../core/run-folds.js";
+import { subagentOutcomeCountsOf } from "../core/subagent-rows.js";
+import { ElicitationsContext } from "./elicitation-context.js";
+import { resolvedSubagentEntryOf, SubagentDispatchesContext, } from "./subagent-group-row.js";
+/** MessageList's per-render derivations, read in one place: the fold
+ *  pass, the hold window, the blocks-mode offsets, the tail receipts and
+ *  the trailing-liveness election. */
+export function useMessageListDerivations(source, { live, typing, turnOpen, markerBoundaries, turnStartIds, decisionSurfacesInShelf, frameClaimsLiveness, emptyFallback, }) {
+    const { cards: elicitationCards } = useContext(ElicitationsContext);
+    const { foldedBlocks, flatRows, displayRows } = useTranscriptFolds(source, {
+        live,
+        turnOpen,
+        markerBoundaries,
+        turnStartIds,
+    });
+    // The current turn's start (the hold window) is the fold pass's own
+    // boundary (core/run-folds.ts): the last user or subagent-delivery row,
+    // or a later DECLARED turn start (agent-mode delivery turns project no
+    // row), so the hold window and the fold window read the same boundaries.
+    // Positional on purpose, never a clock: the optimistic echo is a user
+    // row, so decay fires at send, and a replay renders identically every
+    // time.
+    const currentTurnStart = currentTurnStartOf(displayRows, foldedBlocks, turnStartIds);
+    // Blocks mode renders per block, so each row's flat display index —
+    // what the hold window is measured in — is its block's offset plus
+    // its position in the block.
+    const blockStarts = _blockStartsOf(foldedBlocks ?? []);
+    // An ANSWERED ask whose call never rendered a row (a wire that named
+    // no tool_call_id, a history whose call never reached the messages)
+    // still renders its Q→A receipt at the tail: the member answered, and
+    // that is content. It is the ONE settled-decision tail render left —
+    // the meta-receipt lines were deleted as a product decision.
+    const unrowedAnsweredAsks = decisionSurfacesInShelf
+        ? _unrowedAnsweredAsksOf(flatRows, elicitationCards)
+        : NO_UNROWED_ASKS;
+    // The liveness anchor is simply the last display row: the only trailing
+    // marker row (turn-failed receipts) trails once the run settled.
+    const liveIndex = displayRows.length - 1;
+    // The one trailing-liveness arbiter (a seam, closed at its
+    // mechanism): every element that can claim the beat is decided HERE,
+    // from the same facts its renderer reads, so no host and no tail kind
+    // can double-claim or drop the claim.
+    const dispatchesJoin = useContext(SubagentDispatchesContext);
+    // The host's empty surface owns the empty frame: when the host said
+    // "the log is genuinely empty" AND gave the words for it, a package
+    // "Working…" (or the dot) beside those words is a second liveness
+    // claim in one frame — the run viewer's empty streaming state stacked
+    // "No activity yet." over "Working…". The host surface is the claimant
+    // then; the arbiter yields. An empty live log with NO host surface
+    // keeps the standalone headline — one claim either way.
+    const hostEmptySurfaceShown = !hostFillDeclines(emptyFallback) && displayRows.length === 0;
+    // One yield rule: the host's empty surface showing, or
+    // the host's declared frame claim, each means the frame already
+    // carries the words — the standalone claimants stand down.
+    const livenessClaimant = hostEmptySurfaceShown || frameClaimsLiveness
+        ? "none"
+        : _trailingLivenessClaimantOf(displayRows, live, typing, dispatchesJoin);
+    return {
+        foldedBlocks,
+        displayRows,
+        currentTurnStart,
+        blockStarts,
+        unrowedAnsweredAsks,
+        liveIndex,
+        hostEmptySurfaceShown,
+        livenessClaimant,
+    };
+}
+const NO_UNROWED_ASKS = [];
+/** The fold derivation, pure per render: blocks mode's segmented pass
+ *  or rows mode's flat one. All tool calls stay inside their work fold. */
+function useTranscriptFolds(source, { live, turnOpen, markerBoundaries, turnStartIds, }) {
+    const { rows, blocks } = source;
+    // Blocks mode: the segmented fold pass, so a host marker
+    // splits folds exactly as a visible row would. Rows mode takes the
+    // branch below it always took — the store surfaces' rendering is
+    // pinned by the pixel suite and the store-composition suites
+    // (the invariant-comment ledger, row 13).
+    const foldedBlocks = blocks !== undefined
+        ? foldedBlocksOf(blocks, {
+            openTailTurn: turnOpen ?? live,
+            markerBoundaries,
+            turnStartIds,
+        })
+        : null;
+    const flatRows = rows ?? blocks.flatMap((block) => block.rows);
+    const displayRows = foldedBlocks !== null
+        ? foldedBlocks.flatMap((block) => block.rows)
+        : runFoldsOf(flatRows, {
+            openTailTurn: turnOpen ?? live,
+        });
+    return { foldedBlocks, flatRows, displayRows };
+}
+/** Each block's offset in the flat display order (blocks mode). */
+function _blockStartsOf(blocks) {
+    const starts = [];
+    let next = 0;
+    for (const block of blocks) {
+        starts.push(next);
+        next += block.rows.length;
+    }
+    return starts;
+}
+/** The answered asks with no rendered row to settle on (shelf
+ *  composition): a wire that named no tool_call_id, or a history whose
+ *  call never reached the messages. Their Q→A receipts render
+ *  at the transcript tail — content, never meta-narration. Stale asks
+ *  render nothing: the meta-receipt rows were deleted, the quiet
+ *  stale line with them. */
+function _unrowedAnsweredAsksOf(rows, elicitationCards) {
+    const renderedCallIds = new Set();
+    for (const row of rows) {
+        if (row.kind === "tool-call") {
+            renderedCallIds.add(row.toolCallId);
+        }
+    }
+    return elicitationCards.filter((card) => (card.toolCallId === null || !renderedCallIds.has(card.toolCallId)) &&
+        card.status === "answered");
+}
+/** WHO claims the trailing liveness beat — the one arbiter. Exactly one
+ *  element may say "work is live" at the transcript tail, across every
+ *  host and every tail row kind. Precedence: a claiming tail row (a live
+ *  fold, streaming prose, a delegation group with a running member —
+ *  resolved through the SAME join the group row renders from); else
+ *  `typing` elects the silence-gap dot; else `live` elects the standalone
+ *  Working… headline; else none. The full table is in
+ *  docs/transcript-surfaces.md and tests/liveness-claimants.test.tsx
+ *  executes it. A host-provided empty surface on an empty log outranks
+ *  everything here at the call site. The dot OUTRANKS the headline
+ *  deliberately: the drill-in preview passes typing alongside live and
+ *  keeps its dot; Transcript never passes typing. */
+function _trailingLivenessClaimantOf(displayRows, live, typing, dispatches) {
+    const last = displayRows.at(-1);
+    const tailClaims = last !== undefined &&
+        ((last.kind === "run-fold" && _foldClaimsLiveness(last.members, live)) ||
+            (last.kind === "assistant-text" && last.streaming) ||
+            // The group's own headline shimmers exactly when its resolved
+            // counts say a member runs — resolved through the SAME exported
+            // join the group row renders from (never a respelled predicate),
+            // so the arbiter and the row cannot drift.
+            (last.kind === "subagent-group" &&
+                subagentOutcomeCountsOf(last.entries.map((entry) => resolvedSubagentEntryOf(entry, dispatches.byOrdinal))).running > 0));
+    if (tailClaims) {
+        return "tail-row";
+    }
+    if (typing) {
+        return "typing-dot";
+    }
+    if (live) {
+        return "standalone-headline";
+    }
+    return "none";
+}
+/** One live spelling of "this fold reads as running" — ActivityRail's
+ *  headline and the trailing-liveness arbiter both read it. The trailing
+ *  fold's turnLive bridges the quiet beat between one call's result and
+ *  the next call's start, so back-to-back calls don't blink the headline. */
+export function _foldClaimsLiveness(members, turnLive) {
+    return (turnLive ||
+        members.some((row) => (row.kind === "reasoning" && row.streaming) ||
+            (row.kind === "tool-call" && row.state === "input-available")));
+}
+//# sourceMappingURL=use-transcript-folds.js.map

package/dist/components/use-transcript-folds.js.map

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

package/dist/components/use-transcript.d.ts

@@ -0,0 +1,41 @@
+import type { Message } from "@ag-ui/core";
+import { type AssistantActivitySnapshot } from "../core/activity.js";
+import type { MarkerAnchorsSnapshot } from "../core/connection-epoch.js";
+import { type TranscriptRow } from "../core/transcript-rows.js";
+import type { UserTurnMeta } from "../core/user-turn-ledger.js";
+/** The transcript read surface: everything a host needs to render the
+ *  assistant's replies, derived exactly the way the package chrome derives it. */
+export interface TranscriptSurface {
+    /** transcriptRowsOf(messages, markerAnchors, running, turnMeta) — the
+     *  pure interleave, identity-stable while its four inputs hold. */
+    rows: readonly TranscriptRow[];
+    /** `rows` with the composer's optimistic echo appended (withPendingUserEcho).
+     *  Render this; a host that also paints its own bubble would double it. */
+    displayRows: readonly TranscriptRow[];
+    /** runReadsAsWorking(activity.newestTurnStatus, decisionsPending) — the
+     *  machine's time. False for the send round trip, so a "working" indicator
+     *  should join the composer contract's pendingSend, as the chrome does. */
+    running: boolean;
+    /** The newest turn is non-terminal — broader than `running`: the HITL
+     *  pauses (awaiting_input, parked) count. */
+    turnOpen: boolean;
+    /** A member-actionable decision is live — the run is the MEMBER's time. */
+    decisionsPending: boolean;
+    /** The four raw store reads, as plain values — so transcriptRowsOf(messages,
+     *  markerAnchors, running, turnMeta) type-checks verbatim for a host's own projection. */
+    messages: readonly Message[];
+    markerAnchors: MarkerAnchorsSnapshot;
+    activity: AssistantActivitySnapshot;
+    turnMeta: ReadonlyMap<string, UserTurnMeta>;
+}
+/**
+ * The store's read side, projected: the message list and marker anchors
+ * folded into the flat row list, plus the run-state facts the rows key on.
+ * Mounting registers transcript presence (the lease) — what guarantees the
+ * epoch connects and history paints by full replay; unmounting mid-turn changes nothing.
+ */
+export declare function useTranscript(options?: {
+    /** The lease label the store's presence ledger records (the chrome's `surface` prop). */
+    surface?: string;
+}): TranscriptSurface;
+//# sourceMappingURL=use-transcript.d.ts.map

package/dist/components/use-transcript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-transcript.d.ts","sourceRoot":"","sources":["../../src/components/use-transcript.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAMzE,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAKhE;kFACkF;AAClF,MAAM,WAAW,iBAAiB;IAChC;uEACmE;IACnE,IAAI,EAAE,SAAS,aAAa,EAAE,CAAC;IAC/B;+EAC2E;IAC3E,WAAW,EAAE,SAAS,aAAa,EAAE,CAAC;IACtC;;+EAE2E;IAC3E,OAAO,EAAE,OAAO,CAAC;IACjB;iDAC6C;IAC7C,QAAQ,EAAE,OAAO,CAAC;IAClB,2EAA2E;IAC3E,gBAAgB,EAAE,OAAO,CAAC;IAC1B;8FAC0F;IAC1F,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IAC7B,aAAa,EAAE,qBAAqB,CAAC;IACrC,QAAQ,EAAE,yBAAyB,CAAC;IACpC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CAC7C;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE;IACtC,yFAAyF;IACzF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,iBAAiB,CA8DpB"}

package/dist/components/use-transcript.js

@@ -0,0 +1,66 @@
+"use client";
+// The transcript read surface: the ONE derivation from the store's read cells
+// to renderable rows, consumed by components/transcript.tsx and exported public
+// on ./headless — never ./transcript, since the BINDING to a live store rides
+// the provider, which constructs the transport. Chrome-free by construction
+// (tests/bundle-closure.test.ts): VALUE-imports only core/*, React, ./headless
+// seams.
+import { useEffect, useMemo } from "react";
+import { isTerminalTurnStatus, } from "../core/activity.js";
+import { runReadsAsWorking } from "../core/run-status.js";
+import { approvalAwaitsMember, elicitationAwaitsMember, } from "../core/suspension-queue.js";
+import { transcriptRowsOf, withPendingUserEcho, } from "../core/transcript-rows.js";
+import { useConversation } from "./conversation-context.js";
+import { useAssistantSession } from "./teaflask-assistant-provider.js";
+import { useCell } from "./use-store-cell.js";
+/**
+ * The store's read side, projected: the message list and marker anchors
+ * folded into the flat row list, plus the run-state facts the rows key on.
+ * Mounting registers transcript presence (the lease) — what guarantees the
+ * epoch connects and history paints by full replay; unmounting mid-turn changes nothing.
+ */
+export function useTranscript(options) {
+    const { store } = useAssistantSession();
+    const { pendingEcho } = useConversation();
+    const messages = useCell(store.messages);
+    const markerAnchors = useCell(store.markerAnchors);
+    const approvalCards = useCell(store.approvals);
+    const elicitationCards = useCell(store.elicitations);
+    const activity = useCell(store.activity);
+    const turnMeta = useCell(store.turnMeta);
+    const surface = options?.surface ?? "headless";
+    useEffect(() => store.acquireTranscriptLease(surface), [store, surface]);
+    // The decision-live fact: the one honest signal that the run is the
+    // MEMBER's time — claimed only while a decision surface exists, via the
+    // shared predicates, never the sorted queue (whose row-index input
+    // changes every token). The gap counts too: the role="alert" banner says
+    // the run waits. Truthiness on purpose: a partial snapshot's undefined
+    // is no-gap.
+    const decisionSurfaceLive = useMemo(() => approvalCards.some(approvalAwaitsMember) ||
+        elicitationCards.some(elicitationAwaitsMember), [approvalCards, elicitationCards]);
+    const decisionsPending = decisionSurfaceLive || Boolean(activity.pendingDecisionGap);
+    // "The run is live" is the machine's time: queued/working, or a
+    // non-terminal pause with no live decision surface — the same function the
+    // sr-only announcer speaks, so headline and live region never disagree. It
+    // narrows the tool rows' no-result presentation and the newest rows' streaming flag.
+    const running = runReadsAsWorking(activity.newestTurnStatus, decisionsPending);
+    // "The turn is open" is broader than "the run is live": it includes the HITL
+    // pauses. The completed-episode fold keys on terminality, so a pause never
+    // unifies the tail turn mid-flight and pops it back out on resume.
+    const turnOpen = activity.newestTurnStatus !== null &&
+        !isTerminalTurnStatus(activity.newestTurnStatus);
+    const rows = useMemo(() => transcriptRowsOf(messages, markerAnchors, running, turnMeta), [messages, markerAnchors, running, turnMeta]);
+    const displayRows = useMemo(() => withPendingUserEcho(rows, pendingEcho), [pendingEcho, rows]);
+    return {
+        rows,
+        displayRows,
+        running,
+        turnOpen,
+        decisionsPending,
+        messages,
+        markerAnchors,
+        activity,
+        turnMeta,
+    };
+}
+//# sourceMappingURL=use-transcript.js.map

package/dist/components/use-transcript.js.map

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

package/dist/components/user-message.d.ts

@@ -0,0 +1,11 @@
+import type { TurnAttachment } from "../contract/threads.js";
+export declare function UserMessage({ children, attachments, createdAt, }: {
+    children: string;
+    attachments?: readonly TurnAttachment[];
+    /** The turn's server created_at (ISO-8601) — the bubble's one honest
+     *  clock: the wire carries no per-message timestamp, and a client clock
+     *  would lie on every replay. Absent (the optimistic echo, meta-less
+     *  hosts) renders no stamp — never a wrong one. */
+    createdAt?: string;
+}): import("react").JSX.Element;
+//# sourceMappingURL=user-message.d.ts.map

package/dist/components/user-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-message.d.ts","sourceRoot":"","sources":["../../src/components/user-message.tsx"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAI7D,wBAAgB,WAAW,CAAC,EAC1B,QAAQ,EACR,WAAgB,EAChB,SAAS,GACV,EAAE;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IACxC;;;uDAGmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,+BAiCA"}

package/dist/components/user-message.js

@@ -0,0 +1,24 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+// The adopted register — bake-off 2026-07-30 (assistant-ui thread.tsx's user message): a muted
+// rounded-xl bubble right-anchored behind a wide reserved gutter, so
+// long messages never crowd the left edge. assistant-ui's markup with
+// the action bar and branch picker removed (the widget has neither).
+// Attachments stack above the bubble, right-anchored with it; an
+// attachment-only message is just the stack, no empty bubble.
+//
+// Beneath the bubble, one reserved meta row: the turn's timestamp and
+// the package's one copy affordance are both hover/focus-revealed (the
+// roster chevron's reveal idiom; always visible on coarse pointers).
+// The row's height is reserved whether or not the button shows, so the
+// reveal never shifts the message. An attachment-only message renders
+// no meta row: there is no text to copy, and its turn's stamp has no
+// bubble to belong to.
+import { conversationalTimeOf } from "../core/time-labels.js";
+import { AttachmentChips } from "./attachment-chips.js";
+import { CopyTextButton } from "./copy-text-button.js";
+export function UserMessage({ children, attachments = [], createdAt, }) {
+    const time = createdAt !== undefined ? conversationalTimeOf(createdAt) : null;
+    return (_jsxs("div", { className: "tf:group/user-message tf:flex tf:flex-col tf:items-end tf:gap-2 tf:ps-20", "data-role": "user", children: [_jsx(AttachmentChips, { attachments: attachments }), children !== "" ? (_jsxs(_Fragment, { children: [_jsx("div", { className: "tf:min-w-0 tf:rounded-xl tf:bg-tf-muted tf:px-4 tf:py-2 tf:text-tf-body tf:break-words tf:whitespace-pre-wrap tf:text-tf-foreground", children: children }), _jsxs("div", { className: "tf:flex tf:h-7 tf:items-center tf:justify-end tf:gap-1", children: [time !== null ? (_jsx("time", { dateTime: createdAt, title: time.full, className: "tf:text-xs tf:text-tf-muted-foreground tf:opacity-0 tf:transition-opacity tf:group-hover/user-message:opacity-100 tf:group-focus-within/user-message:opacity-100 tf:pointer-coarse:opacity-100", children: time.label })) : null, _jsx(CopyTextButton, { text: children, label: "Copy message", className: "tf:opacity-0 tf:transition-opacity tf:group-hover/user-message:opacity-100 tf:group-focus-within/user-message:opacity-100 tf:focus-visible:opacity-100 tf:pointer-coarse:opacity-100" })] })] })) : null] }));
+}
+//# sourceMappingURL=user-message.js.map

package/dist/components/user-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-message.js","sourceRoot":"","sources":["../../src/components/user-message.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,+FAA+F;AAC/F,qEAAqE;AACrE,sEAAsE;AACtE,qEAAqE;AACrE,iEAAiE;AACjE,8DAA8D;AAC9D,EAAE;AACF,sEAAsE;AACtE,uEAAuE;AACvE,qEAAqE;AACrE,uEAAuE;AACvE,sEAAsE;AACtE,qEAAqE;AACrE,uBAAuB;AAEvB,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,UAAU,WAAW,CAAC,EAC1B,QAAQ,EACR,WAAW,GAAG,EAAE,EAChB,SAAS,GASV;IACC,MAAM,IAAI,GAAG,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9E,OAAO,CACL,eACE,SAAS,EAAC,0EAA0E,eAC1E,MAAM,aAEhB,KAAC,eAAe,IAAC,WAAW,EAAE,WAAW,GAAI,EAC5C,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAC,CACjB,8BACE,cAAK,SAAS,EAAC,qIAAqI,YACjJ,QAAQ,GACL,EACN,eAAK,SAAS,EAAC,wDAAwD,aACpE,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,CACf,eACE,QAAQ,EAAE,SAAS,EACnB,KAAK,EAAE,IAAI,CAAC,IAAI,EAChB,SAAS,EAAC,gMAAgM,YAEzM,IAAI,CAAC,KAAK,GACN,CACR,CAAC,CAAC,CAAC,IAAI,EACR,KAAC,cAAc,IACb,IAAI,EAAE,QAAQ,EACd,KAAK,EAAC,cAAc,EACpB,SAAS,EAAC,sLAAsL,GAChM,IACE,IACL,CACJ,CAAC,CAAC,CAAC,IAAI,IACJ,CACP,CAAC;AACJ,CAAC"}

package/dist/contract/actions-adapter.d.ts

@@ -0,0 +1,53 @@
+/** The catalog identity of the action being executed — server-built, never model prose. */
+export interface ActionIntentAction {
+    slug: string;
+    title: string;
+}
+/**
+ * One action the assistant asks this page to perform: the server-built
+ * request — method, path template, validated arguments — from the org's
+ * vetted actions catalog. `pathTemplate` is app-relative
+ * ("/subscriptions/{subscription_id}"); the origin is always the
+ * adapter's own.
+ */
+export interface ActionIntent {
+    action: ActionIntentAction;
+    method: string;
+    pathTemplate: string;
+    pathParams: Record<string, unknown>;
+    query: Record<string, unknown>;
+    /** The JSON request body; absent when the action sends none. */
+    body?: unknown;
+}
+/**
+ * Session-cookie APIs: the package assembles the URL under `baseUrl` and
+ * fetches with credentials included — the request runs in the user's own
+ * session, so the assistant can do nothing the user couldn't.
+ */
+export interface CookiesActionsAdapter {
+    kind: "cookies";
+    baseUrl: string;
+}
+/**
+ * Token-auth APIs: the package assembles the URL under `baseUrl` and
+ * asks `getHeaders` per action (may be async — mint or refresh inside).
+ */
+export interface HeadersActionsAdapter {
+    kind: "headers";
+    baseUrl: string;
+    getHeaders: (intent: ActionIntent) => Record<string, string> | Promise<Record<string, string>>;
+}
+/**
+ * Full control: the host's own request wrapper receives the whole intent
+ * and resolves with the API's response body. A resolved promise reads as
+ * a success; a rejection reads as a failed execution and is reported to
+ * the assistant as such — the convention every wrapper in this class
+ * (an orval mutator, an axios instance) already follows by throwing on
+ * non-2xx.
+ */
+export interface RequestActionsAdapter {
+    kind: "request";
+    execute: (intent: ActionIntent) => Promise<unknown>;
+}
+export type ActionsAdapter = CookiesActionsAdapter | HeadersActionsAdapter | RequestActionsAdapter;
+//# sourceMappingURL=actions-adapter.d.ts.map

package/dist/contract/actions-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions-adapter.d.ts","sourceRoot":"","sources":["../../src/contract/actions-adapter.ts"],"names":[],"mappings":"AAWA,2FAA2F;AAC3F,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,gEAAgE;IAChE,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AACD;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,CACV,MAAM,EAAE,YAAY,KACjB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC/D;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACrD;AAED,MAAM,MAAM,cAAc,GACxB,qBAAqB,GAAG,qBAAqB,GAAG,qBAAqB,CAAC"}

package/dist/contract/actions-adapter.js

@@ -0,0 +1,10 @@
+// The actions-adapter contract — the one seam a host wires to let the
+// assistant act against its own API. FROZEN and
+// additive-only forever: fields may be added, never renamed, retyped, or
+// removed. The package never sniffs the host's fetch and never asks for
+// per-endpoint registration — one adapter serves the whole catalog. The
+// request's origin always belongs to the adapter: intents carry only a
+// relative path template, so a compromised turn cannot point a request
+// anywhere the host didn't choose.
+export {};
+//# sourceMappingURL=actions-adapter.js.map

package/dist/contract/actions-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions-adapter.js","sourceRoot":"","sources":["../../src/contract/actions-adapter.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,gDAAgD;AAChD,yEAAyE;AACzE,wEAAwE;AACxE,wEAAwE;AACxE,uEAAuE;AACvE,uEAAuE;AACvE,mCAAmC"}

package/dist/contract/assistant-config.d.ts

@@ -0,0 +1,2 @@
+export type { AssistantConfigResponse, AttachmentPolicyResponse as ServedAttachmentPolicy, ModelChoiceResponse as ServedModelChoice, RouteSuggestions as ServedRouteSuggestions, SuggestionsConfig as ServedSuggestionsConfig, ThinkingEffort as ServedThinkingEffort, } from "../generated/models/index.js";
+//# sourceMappingURL=assistant-config.d.ts.map

package/dist/contract/assistant-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-config.d.ts","sourceRoot":"","sources":["../../src/contract/assistant-config.ts"],"names":[],"mappings":"AAIA,YAAY,EACV,uBAAuB,EACvB,wBAAwB,IAAI,sBAAsB,EAClD,mBAAmB,IAAI,iBAAiB,EACxC,gBAAgB,IAAI,sBAAsB,EAC1C,iBAAiB,IAAI,uBAAuB,EAC5C,cAAc,IAAI,oBAAoB,GACvC,MAAM,8BAA8B,CAAC"}

package/dist/contract/assistant-config.js

@@ -0,0 +1,5 @@
+// The assistant-config read: the authored widget configuration served at
+// runtime. The shapes are generated from serving-openapi.json; this file
+// keeps the package's public names stable over the generated ones.
+export {};
+//# sourceMappingURL=assistant-config.js.map

package/dist/contract/assistant-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-config.js","sourceRoot":"","sources":["../../src/contract/assistant-config.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,yEAAyE;AACzE,mEAAmE"}

package/dist/contract/dispatches.d.ts

@@ -0,0 +1,32 @@
+import { AgentDispatchStatus } from "../generated/models/index.js";
+export type { ServingAgentDispatchResponse as ThreadDispatch } from "../generated/models/index.js";
+export type ThreadDispatchStatus = AgentDispatchStatus;
+export declare function dispatchIsRunning(dispatch: {
+    status: ThreadDispatchStatus;
+}): boolean;
+export declare function dispatchFailed(dispatch: {
+    status: ThreadDispatchStatus;
+}): boolean;
+/** Paused for an answer only the member's browser can give — a running
+ *  row whose request the transcript can name. */
+export declare function dispatchIsPaused(dispatch: {
+    status: ThreadDispatchStatus;
+}): boolean;
+/** Whether the ledger AFFIRMATIVELY says this child is done — a row we
+ *  hold whose status is succeeded or failed. The one predicate a
+ *  stream-end verdict may read "settled" from: its
+ *  complement is not "running" but "not known to have settled", which
+ *  covers a still-dispatched row AND no row at all — a ledger read that
+ *  bounded out or failed with no prior snapshot. A ledger not read is not
+ *  a ledger that settled (the backend's own null posture on the
+ *  sse_stream_teardown line), so undefined answers false here, and a
+ *  judge asking "did it settle?" through this predicate can never turn an
+ *  unreadable ledger into Finished. Enumerated over every state:
+ *
+ *    dispatched → false     succeeded → true
+ *    paused     → false     failed    → true
+ *    undefined (unread) → false */
+export declare function dispatchHasSettled(dispatch: {
+    status: ThreadDispatchStatus;
+} | undefined): boolean;
+//# sourceMappingURL=dispatches.d.ts.map

package/dist/contract/dispatches.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatches.d.ts","sourceRoot":"","sources":["../../src/contract/dispatches.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAEnE,YAAY,EAAE,4BAA4B,IAAI,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEnG,MAAM,MAAM,oBAAoB,GAAG,mBAAmB,CAAC;AASvD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE;IAC1C,MAAM,EAAE,oBAAoB,CAAC;CAC9B,GAAG,OAAO,CAKV;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE;IACvC,MAAM,EAAE,oBAAoB,CAAC;CAC9B,GAAG,OAAO,CAEV;AAED;iDACiD;AACjD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE;IACzC,MAAM,EAAE,oBAAoB,CAAC;CAC9B,GAAG,OAAO,CAEV;AAED;;;;;;;;;;;;;mCAamC;AACnC,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE;IAAE,MAAM,EAAE,oBAAoB,CAAA;CAAE,GAAG,SAAS,GACrD,OAAO,CAYT"}

package/dist/contract/dispatches.js

@@ -0,0 +1,57 @@
+// The thread's subagent dispatch ledger: the serving projection
+// is receipts/status/summary — no row id, no model; summary is
+// the child report's bounded excerpt stamped at settle — and the
+// package's public names for it stay stable over the generated ones.
+// Rows join the
+// transcript's dispatch receipts by ORDINAL — the ask's identity;
+// child_session_id is the drill-in handle, and a resume
+// chain shares it across rows — and the row's status outranks the
+// receipt's frozen outcome (the serving contract, "Reading a thread's
+// subagent dispatches").
+import { AgentDispatchStatus } from "../generated/models/index.js";
+// The predicates take the generated union, never bare string — a renamed
+// status word in the spec must fail the compile here, not silently turn
+// every ledger row into finished-and-not-failed (the dashboard's
+// dispatch-status twin takes the same posture).
+// Running means the child still owns its row: dispatched, or paused for
+// an answer it cannot give itself — both are open, unsettled.
+export function dispatchIsRunning(dispatch) {
+    return (dispatch.status === AgentDispatchStatus.dispatched ||
+        dispatch.status === AgentDispatchStatus.paused);
+}
+export function dispatchFailed(dispatch) {
+    return dispatch.status === AgentDispatchStatus.failed;
+}
+/** Paused for an answer only the member's browser can give — a running
+ *  row whose request the transcript can name. */
+export function dispatchIsPaused(dispatch) {
+    return dispatch.status === AgentDispatchStatus.paused;
+}
+/** Whether the ledger AFFIRMATIVELY says this child is done — a row we
+ *  hold whose status is succeeded or failed. The one predicate a
+ *  stream-end verdict may read "settled" from: its
+ *  complement is not "running" but "not known to have settled", which
+ *  covers a still-dispatched row AND no row at all — a ledger read that
+ *  bounded out or failed with no prior snapshot. A ledger not read is not
+ *  a ledger that settled (the backend's own null posture on the
+ *  sse_stream_teardown line), so undefined answers false here, and a
+ *  judge asking "did it settle?" through this predicate can never turn an
+ *  unreadable ledger into Finished. Enumerated over every state:
+ *
+ *    dispatched → false     succeeded → true
+ *    paused     → false     failed    → true
+ *    undefined (unread) → false */
+export function dispatchHasSettled(dispatch) {
+    if (dispatch === undefined) {
+        return false;
+    }
+    switch (dispatch.status) {
+        case AgentDispatchStatus.succeeded:
+        case AgentDispatchStatus.failed:
+            return true;
+        case AgentDispatchStatus.dispatched:
+        case AgentDispatchStatus.paused:
+            return false;
+    }
+}
+//# sourceMappingURL=dispatches.js.map

package/dist/contract/dispatches.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatches.js","sourceRoot":"","sources":["../../src/contract/dispatches.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,+DAA+D;AAC/D,iEAAiE;AACjE,qEAAqE;AACrE,gBAAgB;AAChB,kEAAkE;AAClE,wDAAwD;AACxD,kEAAkE;AAClE,sEAAsE;AACtE,yBAAyB;AAEzB,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAMnE,yEAAyE;AACzE,wEAAwE;AACxE,iEAAiE;AACjE,gDAAgD;AAEhD,wEAAwE;AACxE,8DAA8D;AAC9D,MAAM,UAAU,iBAAiB,CAAC,QAEjC;IACC,OAAO,CACL,QAAQ,CAAC,MAAM,KAAK,mBAAmB,CAAC,UAAU;QAClD,QAAQ,CAAC,MAAM,KAAK,mBAAmB,CAAC,MAAM,CAC/C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,QAE9B;IACC,OAAO,QAAQ,CAAC,MAAM,KAAK,mBAAmB,CAAC,MAAM,CAAC;AACxD,CAAC;AAED;iDACiD;AACjD,MAAM,UAAU,gBAAgB,CAAC,QAEhC;IACC,OAAO,QAAQ,CAAC,MAAM,KAAK,mBAAmB,CAAC,MAAM,CAAC;AACxD,CAAC;AAED;;;;;;;;;;;;;mCAamC;AACnC,MAAM,UAAU,kBAAkB,CAChC,QAAsD;IAEtD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,QAAQ,QAAQ,CAAC,MAAM,EAAE,CAAC;QACxB,KAAK,mBAAmB,CAAC,SAAS,CAAC;QACnC,KAAK,mBAAmB,CAAC,MAAM;YAC7B,OAAO,IAAI,CAAC;QACd,KAAK,mBAAmB,CAAC,UAAU,CAAC;QACpC,KAAK,mBAAmB,CAAC,MAAM;YAC7B,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC"}

package/dist/contract/errors.d.ts

@@ -0,0 +1,12 @@
+export type { ServingErrorCode } from "../generated/models/index.js";
+import type { ServingErrorCode } from "../generated/models/index.js";
+export type ServingErrorCodeOnTheWire = ServingErrorCode | (string & {});
+export interface ServingErrorBody {
+    code: ServingErrorCodeOnTheWire;
+    message: string;
+    details?: unknown;
+}
+export interface ServingErrorEnvelope {
+    error: ServingErrorBody;
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/contract/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/contract/errors.ts"],"names":[],"mappings":"AAMA,YAAY,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAIrE,MAAM,MAAM,yBAAyB,GAAG,gBAAgB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAEzE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,yBAAyB,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,gBAAgB,CAAC;CACzB"}

package/dist/contract/errors.js

@@ -0,0 +1,7 @@
+// The error envelope every non-2xx serving answer rides. The code
+// vocabulary is generated from serving-openapi.json; the envelope shape
+// stays hand-written because the generated ErrorEnvelope carries the
+// dashboard's full closed ApiErrorCode, while this public surface wants
+// the serving codes plus forward compatibility.
+export {};
+//# sourceMappingURL=errors.js.map

package/dist/contract/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/contract/errors.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,wEAAwE;AACxE,qEAAqE;AACrE,wEAAwE;AACxE,gDAAgD"}