@teaflask/assistant 0.3.0 → 0.7.0

package/dist/components/tool-views/docs-search-view.js

@@ -1,26 +1,7 @@
-// teaflask.docs-search — the package's view for the docs_search tool
-// (tool-views.md, rung 3): the sections the search returned as list rows
-// in a card — title and heading, the section's address and dates, the
-// matched text — instead of one prose block. It renders the recorded
-// call alone: the hit list is parsed from the tool's own text format
-// (docs_search.py::_render_hits), authored knowledge of our own tool,
-// never a shape sniffed off arbitrary output. Anything that is not that
-// format renders verbatim in a pane, so a format change degrades to the
-// honest text rather than a wrong structure.
-//   settledOutcomeNotesOf arms — REACHABLE: a refused, errored
-//     (output-error), denied, cancelled, superseded or offloaded call
-//     renders its arm; a still-running call renders none (the switch
-//     breaks out); see view-dom.ts.
-//   call.truncated arm — channel 1 only (the envelope flag); the
-//     mapper's 20k clip is invisible here and a cut hit list renders
-//     its complete hits with the cut tail as its last hit's text.
 import { CARD_BLOCK_CLASS, CARD_TITLE_CLASS } from "./parts-classes.js";
 import { badge, boneRows, captionRow, card, el, fileGlyph, listRow, note, pane, scrollRegion, settledOutcomeNotesOf, settledWithResult, statelessToolView, stringOf, } from "./view-dom.js";
-/** The producer's no-hits sentence, verbatim (docs_search.py). */
 const NO_HITS_SENTENCE = "No documentation sections matched this query.";
-/** `[slug#anchor] Title › Heading` — the first line of every hit. */
 const HIT_HEADLINE = /^\[([^\]#\s]+)#([^\]\s]*)\] (.*)$/;
-/** `Updated: 2026-09-01 · Verified: 2026-09-03` — the optional facts line. */
 const HIT_FACTS = /^Updated: \d{4}-\d{2}-\d{2}( · Verified: \d{4}-\d{2}-\d{2})?$/;
 const EXCERPT_CLASS = "tf:mt-0.5 tf:line-clamp-2 tf:text-xs tf:text-tf-muted-foreground";
 export const docsSearchToolView = statelessToolView(_renderDocsSearch);
@@ -35,9 +16,6 @@ function _renderDocsSearch({ call }) {
     if (!settledWithResult(call) || call.resultText === undefined) {
         if (call.status === "input-streaming" ||
             call.status === "input-available") {
-            // A gated call is not in flight: the consent reading is the query
-            // as a proposal row with the wait as its badge, never pulsing bones
-            // beside a "Needs input" pill.
             root.append(call.awaitingDecision
                 ? _proposalCard(query)
                 : el("p", CARD_TITLE_CLASS, title));
@@ -57,8 +35,6 @@ function _renderDocsSearch({ call }) {
     }
     const hits = docsSearchHitsOf(call.resultText);
     if (hits === null) {
-        // The card title already names the results; the pane's label says
-        // what the pane is — the record as it stands, not the format.
         root.append(card([_cardInterior(pane("As recorded", call.resultText))], title));
         return root;
     }
@@ -76,11 +52,6 @@ function _proposalCard(query) {
     row.dataset.tfDocsSearchProposal = "";
     return card([row]);
 }
-/** The hit list, or null when the text is not the producer's format.
- *  A hit ends where the next begins — a blank line and then a headline
- *  line (_render_hits joins hits with one blank line) — never at a blank
- *  line alone: a section's content keeps its own paragraph breaks
- *  (mdv1_chunker rejoins a section's blocks with blank lines). */
 export function docsSearchHitsOf(resultText) {
     const lines = resultText.split("\n");
     let headline = HIT_HEADLINE.exec(lines[0] ?? "");
@@ -97,7 +68,6 @@ export function docsSearchHitsOf(resultText) {
         if (!atEnd && next === null) {
             continue;
         }
-        // The separator blank line belongs to neither hit.
         hits.push(_hitOf(headline, lines.slice(start, atEnd ? index : index - 1)));
         if (next === null) {
             break;
@@ -109,8 +79,6 @@ export function docsSearchHitsOf(resultText) {
 }
 function _hitOf(headline, body) {
     const [, slug, anchor, titleAndHeading] = headline;
-    // The producer appends the heading once, at the end (`{title} › {heading}`),
-    // so the LAST separator is the join — a title may carry the glyph itself.
     const separator = titleAndHeading.lastIndexOf(" › ");
     const title = separator === -1 ? titleAndHeading : titleAndHeading.slice(0, separator);
     const heading = separator === -1 ? null : titleAndHeading.slice(separator + 3);
@@ -118,18 +86,12 @@ function _hitOf(headline, body) {
     const content = body.slice(facts === null ? 0 : 1).join("\n");
     return { slug, anchor, title, heading, facts, content };
 }
-/** The card's interior for a flush block (the pane): the card-child
- *  grammar every non-row block wears — the rows' inset, a hairline
- *  above unless it opens the card. */
 function _cardInterior(child) {
     const wrapper = el("div", CARD_BLOCK_CLASS);
     wrapper.append(child);
     return wrapper;
 }
 function _hitRow(hit) {
-    // The row reads like a document row: the doc's title, then where in it
-    // the match sits (its heading, its address). The dates the producer
-    // appends are model-facing evidence and stay off the row.
     const where = hit.heading === null || hit.heading === ""
         ? hit.slug
         : `${hit.heading} · ${hit.slug}`;
@@ -145,4 +107,3 @@ function _hitRow(hit) {
     row.dataset.tfDocsSearchHit = hit.slug;
     return row;
 }
-//# sourceMappingURL=docs-search-view.js.map

package/dist/components/tool-views/file-edit-view.js

@@ -1,22 +1,3 @@
-// teaflask.file-edit — the recorded edit as a diff (tool-views.md,
-// rung 3). The diff derives from the ARGS — str_replace carries the
-// full old/new pair, insert its added lines, create the whole file —
-// because the result carries only a post-edit snippet. On a settled
-// call the editor applied exactly this change (unique-occurrence
-// enforced backend-side); before it settles the same shape is labeled
-// a proposal, so the view never claims an edit that hasn't happened.
-// Producer transforms, argument ledger and the boundary-newline
-// cross-product: docs/tool-view-ledgers.md. Arm reachability and the
-// two truncation channels (the diff arms derive from the ARGS and are
-// immune to both): the tool-view arm-reachability record.
-//   settledOutcomeNotesOf arms — REACHABLE: tool-row no longer gates
-//     output, so the refused/output-error/denied/cancelled/superseded/
-//     offloaded settles render their arms in production (a
-//     still-running call renders none — the switch breaks out); see
-//     view-dom.ts.
-//   elision marking (_diffPane) — every recorded line the Myers pane
-//     does not render is marked with a ⋯: leading, between hunks, and
-//     trailing. A pane without ⋯ IS the whole recorded fragment.
 import { unifiedDiffOf } from "../../reader/line-diff.js";
 import { LABEL_CLASS, PANE_CLASS, PANE_WRAPPER_CLASS, el, note, pane, settledOutcomeNotesOf, settledWithResult, statelessToolView, stringOf, } from "./view-dom.js";
 export const fileEditToolView = statelessToolView(_renderFileEdit);
@@ -53,17 +34,11 @@ function _renderFileEdit({ call }) {
 }
 function _strReplaceReadingOf(call, settled) {
     const oldStr = stringOf(call.args.old_str);
-    // new_str is optional for str_replace and omitting it DELETES the
-    // match (the editor expands a missing or empty new_str to "") — so an
-    // absent value is a deletion to render, and only a wrong-typed one is
-    // unrenderable.
     const rawNewStr = call.args.new_str;
     const newStr = rawNewStr === undefined || rawNewStr === null ? "" : stringOf(rawNewStr);
     if (oldStr === null || newStr === null) {
         return note("No rendered edit for this call.");
     }
-    // The editor matches and writes tab-EXPANDED fragments, so the file
-    // received these bytes, and equality is judged on them.
     const expandedOld = _expandedTabs(oldStr);
     const expandedNew = _expandedTabs(newStr);
     if (newStr === "" && oldStr !== "") {
@@ -81,12 +56,8 @@ function _createReadingOf(call, settled) {
         return note("No rendered edit for this call.");
     }
     if (fileText === "") {
-        // An empty file has no added lines; a bare "+" would claim one.
         return note(settled ? "Created an empty file." : "Proposes an empty file.");
     }
-    // Verbatim on purpose: create is the one command the editor does NOT
-    // tab-expand, and a leading newline really is a blank first line —
-    // only the trailing terminator drops.
     return _diffPane(settled ? "New file" : "Proposed new file", _prefixedLines(_withoutTrailingNewline(fileText), "+"));
 }
 function _insertReadingOf(call, settled) {
@@ -95,22 +66,11 @@ function _insertReadingOf(call, settled) {
         return note("No rendered edit for this call.");
     }
     const line = call.args.insert_line;
-    // insert_line counts the existing lines that PRECEDE the insertion —
-    // the editor splices at file_text_lines[:insert_line] and accepts
-    // only integers in [0, n_lines] — so 0 is the top of the file, a
-    // positive integer reads as the ordinary "after line N" (1-indexed
-    // reading), and anything the editor would refuse (negative,
-    // fractional, non-number) claims no position at all. The vended
-    // docstring says "0-indexed"; its own splice contradicts it, and the
-    // splice is what runs.
     const where = typeof line !== "number" || !Number.isInteger(line) || line < 0
         ? ""
         : line === 0
             ? " at the top of the file"
             : ` after line ${String(line)}`;
-    // Tab-expanded (the splice inserts expanded lines), but no boundary
-    // drops: split("\n") is spliced verbatim, so leading and trailing
-    // newlines really insert blank lines.
     return _diffPane(settled ? `Inserted${where}` : `Proposed insertion${where}`, _prefixedLines(_expandedTabs(newStr), "+"));
 }
 function _viewedContentsReadingOf(call, settled) {
@@ -120,29 +80,17 @@ function _viewedContentsReadingOf(call, settled) {
     if (call.resultText === undefined || call.resultText === "") {
         return note("Nothing to show for this read.");
     }
-    // "Contents", not "File": a view over a directory returns a listing,
-    // and the recorded args cannot tell the two apart.
     return pane("Contents", _withoutViewPreamble(call.resultText));
 }
-/** The editor's own transform: "\t" → 8 spaces, applied to old_str and
- *  new_str (never file_text) before matching and writing. */
 function _expandedTabs(text) {
     return text.replaceAll("\t", "        ");
 }
-/** One trailing "\n" is a terminator, not a line. */
 function _withoutTrailingNewline(text) {
     return text.endsWith("\n") ? text.slice(0, -1) : text;
 }
-/** Deletion drops one newline at EACH boundary: the leading one is the
- *  preceding line's terminator consumed as the joint, the trailing one
- *  the last deleted line's own (the cross-product above). */
 function _withoutBoundaryNewlines(text) {
     return _withoutTrailingNewline(text.startsWith("\n") ? text.slice(1) : text);
 }
-/** A view result is never bare contents: the vended tool opens with one
- *  deterministic model-facing sentence (file or directory form, both
- *  ending in ":"), restating the path the header line above already
- *  shows — dropped so the pane holds the recorded read alone. */
 function _withoutViewPreamble(text) {
     const newline = text.indexOf("\n");
     if (newline === -1) {
@@ -160,17 +108,6 @@ function _prefixedLines(text, prefix) {
         .map((line) => `${prefix}${line}`)
         .join("\n");
 }
-/** The diff register: additions in foreground ink, deletions in the
- *  status voice, context muted (no success token exists in Graphite —
- *  none is minted). Hunk headers render as quiet ⋯ separators: their
- *  offsets are relative to the recorded fragment, and printing numbers
- *  that read as file lines would be a wrong claim — but every ELISION
- *  is marked: a first hunk opening past the
- *  fragment's first line gets a leading ⋯, and when `oldLineCount` is
- *  given (the Myers arm), recorded lines past the last hunk get a
- *  trailing ⋯ — the pane never reads as a complete diff of a fragment
- *  it elided. Lines join with prepended newlines so the pane carries no
- *  trailing empty line box. */
 function _diffPane(label, diff, oldLineCount) {
     const wrapper = el("div", PANE_WRAPPER_CLASS);
     wrapper.append(el("p", LABEL_CLASS, label));
@@ -181,9 +118,6 @@ function _diffPane(label, diff, oldLineCount) {
         code.append(el("span", className, rendered === 0 ? text : `\n${text}`));
         rendered += 1;
     };
-    // The first recorded-fragment line AFTER the last hunk (1-indexed),
-    // from the header's own `-start,count` — the only place the diff
-    // says how far it reached.
     let afterLastHunk = null;
     for (const line of diff.split("\n")) {
         if (line.startsWith("@@")) {
@@ -191,9 +125,6 @@ function _diffPane(label, diff, oldLineCount) {
             if (header !== null) {
                 afterLastHunk = Number(header[1]) + Number(header[2]);
             }
-            // A hunk opening at the fragment's first line elides nothing
-            // before it; every other header stands for skipped recorded
-            // lines and must say so.
             if (rendered > 0 || !line.startsWith("@@ -1,")) {
                 append("tf:text-tf-muted-foreground", "⋯");
             }
@@ -215,4 +146,3 @@ function _diffPane(label, diff, oldLineCount) {
     wrapper.append(pre);
     return wrapper;
 }
-//# sourceMappingURL=file-edit-view.js.map

package/dist/components/tool-views/parts-classes.d.ts

@@ -1,47 +1,28 @@
-export declare const CARD_CLASS = "tf:overflow-hidden tf:rounded-lg tf:border tf:border-tf-border tf:bg-tf-card";
+export declare const CARD_CLASS = "tf:overflow-hidden tf:rounded-lg tf:border tf:border-tf-border tf:bg-tf-card tf:text-tf-card-foreground";
 export declare const CARD_TITLE_CLASS = "tf:mb-1 tf:text-tf-label tf:font-medium tf:text-tf-foreground";
 export declare const ROW_CLASS = "tf:flex tf:min-w-0 tf:items-center tf:gap-2.5 tf:border-t tf:border-tf-border tf:px-2.5 tf:py-1.5 tf:first:border-t-0";
-export declare const ROW_LINK_CLASS = "tf:no-underline tf:hover:bg-tf-accent";
+export declare const ROW_LINK_CLASS = "tf:group/row tf:text-inherit tf:no-underline tf:hover:bg-tf-accent";
 export declare const ROW_ICON_CLASS = "tf:flex tf:size-6 tf:shrink-0 tf:items-center tf:justify-center tf:rounded-[5px] tf:bg-tf-muted tf:text-tf-muted-foreground";
 export declare const ROW_TEXT_CLASS = "tf:flex tf:min-w-0 tf:flex-1 tf:flex-col tf:leading-[1.35]";
-export declare const ROW_TITLE_CLASS = "tf:truncate tf:text-tf-label tf:font-medium tf:text-tf-foreground";
+export declare const ROW_TITLE_CLASS = "tf:truncate tf:text-tf-label tf:font-medium tf:text-tf-card-foreground tf:group-hover/row:text-tf-accent-foreground";
 export declare const ROW_SECONDARY_CLASS = "tf:truncate tf:text-xs tf:text-tf-muted-foreground";
 export declare const ROW_TRAIL_CLASS = "tf:ms-auto tf:flex tf:shrink-0 tf:items-center tf:gap-2";
-export declare const BADGE_CLASS = "tf:inline-flex tf:shrink-0 tf:items-center tf:rounded-[3px] tf:border tf:border-tf-border tf:px-1.5 tf:py-px tf:text-[11px] tf:leading-4 tf:font-medium tf:text-tf-foreground";
-/** The property-row list: a hairline above it when it follows a caption
- *  or a row, none when it opens the card — the rows' own first-child rule,
- *  applied to their container. */
+export declare const BADGE_CLASS = "tf:inline-flex tf:shrink-0 tf:items-center tf:rounded-[3px] tf:border tf:border-tf-border tf:px-1.5 tf:py-px tf:text-[11px] tf:leading-4 tf:font-medium tf:text-tf-card-foreground tf:group-hover/row:text-tf-accent-foreground";
 export declare const FACT_LIST_CLASS = "tf:m-0 tf:border-t tf:border-tf-border tf:first:border-t-0";
 export declare const FACT_ROW_CLASS = "tf:grid tf:grid-cols-[minmax(6rem,30%)_minmax(0,1fr)] tf:gap-x-3 tf:border-t tf:border-tf-border tf:px-2.5 tf:py-1.5 tf:first:border-t-0";
 export declare const FACT_LABEL_CLASS = "tf:min-w-0 tf:text-xs tf:text-tf-muted-foreground tf:wrap-anywhere";
-export declare const FACT_VALUE_CLASS = "tf:m-0 tf:min-w-0 tf:text-xs tf:text-tf-foreground tf:wrap-anywhere";
+export declare const FACT_VALUE_CLASS = "tf:m-0 tf:min-w-0 tf:text-xs tf:text-tf-card-foreground tf:wrap-anywhere";
 export declare const CAPTION_ROW_CLASS = "tf:flex tf:items-center tf:justify-between tf:gap-3 tf:border-t tf:border-tf-border tf:px-2.5 tf:py-1.5 tf:text-xs tf:text-tf-muted-foreground tf:first:border-t-0";
-/** A block child of a card that is not a row — a pretty-printed value,
- *  an inset pane, a body: the same hairline above (none when it opens
- *  the card) and the same inset the rows keep. */
 export declare const CARD_BLOCK_CLASS = "tf:border-t tf:border-tf-border tf:px-2.5 tf:py-2 tf:first:border-t-0";
 export declare const BODY_REGION_CLASS = "tf:max-h-72 tf:overflow-auto tf:border-t tf:border-tf-border tf:px-2.5 tf:py-2 tf:first:border-t-0";
 export declare const NOTE_CLASS = "tf:text-xs tf:text-tf-muted-foreground";
-/** Skeleton lines where the result will land: the first a half-width
- *  title, the rest full-width text — pending is a shape, not a sentence,
- *  and it draws no edges: no card, no border, the lines alone. */
 export declare const BONES_CLASS = "tf:flex tf:flex-col tf:gap-2 tf:py-1";
 export declare const BONE_CLASS = "tf:h-2.5 tf:animate-tf-pulse tf:rounded tf:bg-tf-muted";
-/** A label over a pane: the one label-to-pane rhythm (the pane carries
- *  no margin of its own, so a host's reset cannot collapse the gap). */
 export declare const PANE_WRAPPER_CLASS = "tf:flex tf:flex-col tf:gap-1";
-/** The mono pane for text that IS text (a command's output, a diff): on
- *  the muted ground inside a card, never a second border. */
 export declare const PANE_CLASS = "tf:m-0 tf:max-h-60 tf:overflow-auto tf:rounded-md tf:bg-tf-muted tf:p-2 tf:text-xs tf:whitespace-pre-wrap tf:text-tf-foreground";
-/** A command and what it printed, as one terminal block: the prompt line
- *  in the foreground, the streams beneath it in the muted register. */
 export declare const TERMINAL_CLASS = "tf:m-0 tf:max-h-72 tf:overflow-auto tf:rounded-lg tf:border tf:border-tf-border tf:bg-tf-muted tf:px-3 tf:py-2.5 tf:font-mono tf:text-xs tf:leading-5 tf:whitespace-pre-wrap tf:wrap-anywhere tf:text-tf-foreground";
 export declare const TERMINAL_PROMPT_CLASS = "tf:select-none tf:text-tf-muted-foreground";
 export declare const TERMINAL_OUTPUT_CLASS = "tf:mt-1 tf:block tf:text-tf-muted-foreground";
 export declare const TERMINAL_STDERR_CLASS = "tf:mt-1 tf:block tf:text-tf-muted-foreground tf:italic";
-/** A long list or value inside a card scrolls in a bounded well instead
- *  of growing the transcript — a card child itself (hairline above unless
- *  first; its first child's own hairline yields), so one line per edge. */
 export declare const SCROLL_REGION_CLASS = "tf:max-h-72 tf:overflow-auto tf:border-t tf:border-tf-border tf:first:border-t-0";
 export declare const LABEL_CLASS = "tf:text-xs tf:font-medium tf:text-tf-muted-foreground";
-//# sourceMappingURL=parts-classes.d.ts.map

package/dist/components/tool-views/parts-classes.js

@@ -1,54 +1,28 @@
-// The one visual vocabulary every tool view speaks — the package's own
-// built-ins (vanilla, view-dom.ts) and host views (React, parts.tsx) share
-// these strings, so a customer's view and ours read as one system: a
-// hairline card at rest, dense list rows with a title line and a muted
-// second line, a trailing badge, property rows, a quiet caption, a
-// scrolling body region. Graphite: 13px labels, hairline borders, no
-// shadow, and a compact vertical rhythm — 6px row padding, 24px tiles.
-export const CARD_CLASS = "tf:overflow-hidden tf:rounded-lg tf:border tf:border-tf-border tf:bg-tf-card";
+export const CARD_CLASS = "tf:overflow-hidden tf:rounded-lg tf:border tf:border-tf-border tf:bg-tf-card tf:text-tf-card-foreground";
 export const CARD_TITLE_CLASS = "tf:mb-1 tf:text-tf-label tf:font-medium tf:text-tf-foreground";
 export const ROW_CLASS = "tf:flex tf:min-w-0 tf:items-center tf:gap-2.5 tf:border-t tf:border-tf-border tf:px-2.5 tf:py-1.5 tf:first:border-t-0";
-export const ROW_LINK_CLASS = "tf:no-underline tf:hover:bg-tf-accent";
+export const ROW_LINK_CLASS = "tf:group/row tf:text-inherit tf:no-underline tf:hover:bg-tf-accent";
 export const ROW_ICON_CLASS = "tf:flex tf:size-6 tf:shrink-0 tf:items-center tf:justify-center tf:rounded-[5px] tf:bg-tf-muted tf:text-tf-muted-foreground";
 export const ROW_TEXT_CLASS = "tf:flex tf:min-w-0 tf:flex-1 tf:flex-col tf:leading-[1.35]";
-export const ROW_TITLE_CLASS = "tf:truncate tf:text-tf-label tf:font-medium tf:text-tf-foreground";
+export const ROW_TITLE_CLASS = "tf:truncate tf:text-tf-label tf:font-medium tf:text-tf-card-foreground tf:group-hover/row:text-tf-accent-foreground";
 export const ROW_SECONDARY_CLASS = "tf:truncate tf:text-xs tf:text-tf-muted-foreground";
 export const ROW_TRAIL_CLASS = "tf:ms-auto tf:flex tf:shrink-0 tf:items-center tf:gap-2";
-export const BADGE_CLASS = "tf:inline-flex tf:shrink-0 tf:items-center tf:rounded-[3px] tf:border tf:border-tf-border tf:px-1.5 tf:py-px tf:text-[11px] tf:leading-4 tf:font-medium tf:text-tf-foreground";
-/** The property-row list: a hairline above it when it follows a caption
- *  or a row, none when it opens the card — the rows' own first-child rule,
- *  applied to their container. */
+export const BADGE_CLASS = "tf:inline-flex tf:shrink-0 tf:items-center tf:rounded-[3px] tf:border tf:border-tf-border tf:px-1.5 tf:py-px tf:text-[11px] tf:leading-4 tf:font-medium tf:text-tf-card-foreground tf:group-hover/row:text-tf-accent-foreground";
 export const FACT_LIST_CLASS = "tf:m-0 tf:border-t tf:border-tf-border tf:first:border-t-0";
 export const FACT_ROW_CLASS = "tf:grid tf:grid-cols-[minmax(6rem,30%)_minmax(0,1fr)] tf:gap-x-3 tf:border-t tf:border-tf-border tf:px-2.5 tf:py-1.5 tf:first:border-t-0";
 export const FACT_LABEL_CLASS = "tf:min-w-0 tf:text-xs tf:text-tf-muted-foreground tf:wrap-anywhere";
-export const FACT_VALUE_CLASS = "tf:m-0 tf:min-w-0 tf:text-xs tf:text-tf-foreground tf:wrap-anywhere";
+export const FACT_VALUE_CLASS = "tf:m-0 tf:min-w-0 tf:text-xs tf:text-tf-card-foreground tf:wrap-anywhere";
 export const CAPTION_ROW_CLASS = "tf:flex tf:items-center tf:justify-between tf:gap-3 tf:border-t tf:border-tf-border tf:px-2.5 tf:py-1.5 tf:text-xs tf:text-tf-muted-foreground tf:first:border-t-0";
-/** A block child of a card that is not a row — a pretty-printed value,
- *  an inset pane, a body: the same hairline above (none when it opens
- *  the card) and the same inset the rows keep. */
 export const CARD_BLOCK_CLASS = "tf:border-t tf:border-tf-border tf:px-2.5 tf:py-2 tf:first:border-t-0";
 export const BODY_REGION_CLASS = `tf:max-h-72 tf:overflow-auto ${CARD_BLOCK_CLASS}`;
 export const NOTE_CLASS = "tf:text-xs tf:text-tf-muted-foreground";
-/** Skeleton lines where the result will land: the first a half-width
- *  title, the rest full-width text — pending is a shape, not a sentence,
- *  and it draws no edges: no card, no border, the lines alone. */
 export const BONES_CLASS = "tf:flex tf:flex-col tf:gap-2 tf:py-1";
 export const BONE_CLASS = "tf:h-2.5 tf:animate-tf-pulse tf:rounded tf:bg-tf-muted";
-/** A label over a pane: the one label-to-pane rhythm (the pane carries
- *  no margin of its own, so a host's reset cannot collapse the gap). */
 export const PANE_WRAPPER_CLASS = "tf:flex tf:flex-col tf:gap-1";
-/** The mono pane for text that IS text (a command's output, a diff): on
- *  the muted ground inside a card, never a second border. */
 export const PANE_CLASS = "tf:m-0 tf:max-h-60 tf:overflow-auto tf:rounded-md tf:bg-tf-muted tf:p-2 tf:text-xs tf:whitespace-pre-wrap tf:text-tf-foreground";
-/** A command and what it printed, as one terminal block: the prompt line
- *  in the foreground, the streams beneath it in the muted register. */
 export const TERMINAL_CLASS = "tf:m-0 tf:max-h-72 tf:overflow-auto tf:rounded-lg tf:border tf:border-tf-border tf:bg-tf-muted tf:px-3 tf:py-2.5 tf:font-mono tf:text-xs tf:leading-5 tf:whitespace-pre-wrap tf:wrap-anywhere tf:text-tf-foreground";
 export const TERMINAL_PROMPT_CLASS = "tf:select-none tf:text-tf-muted-foreground";
 export const TERMINAL_OUTPUT_CLASS = "tf:mt-1 tf:block tf:text-tf-muted-foreground";
 export const TERMINAL_STDERR_CLASS = "tf:mt-1 tf:block tf:text-tf-muted-foreground tf:italic";
-/** A long list or value inside a card scrolls in a bounded well instead
- *  of growing the transcript — a card child itself (hairline above unless
- *  first; its first child's own hairline yields), so one line per edge. */
 export const SCROLL_REGION_CLASS = "tf:max-h-72 tf:overflow-auto tf:border-t tf:border-tf-border tf:first:border-t-0";
 export const LABEL_CLASS = "tf:text-xs tf:font-medium tf:text-tf-muted-foreground";
-//# sourceMappingURL=parts-classes.js.map

package/dist/components/tool-views/parts.d.ts

@@ -1,49 +1,85 @@
 import type { ReactNode } from "react";
-/** The small label over a card — or over a skeleton, which draws no card. */
+/**
+ * The small label shown above a card. Use it on its own above ToolViewBones,
+ * which draw no card.
+ */
 export declare function ToolViewTitle({ children }: {
     children: ReactNode;
 }): import("react").JSX.Element;
+/**
+ * A bordered card holding rows, facts, captions or a body, with an optional
+ * small `title` above it; the base container for a tool view built from these
+ * parts, so it matches the assistant's built-in views.
+ */
 export declare function ToolViewCard({ title, children, ...rest }: {
     title?: string;
     children: ReactNode;
 } & Record<`data-${string}`, string | number | undefined>): import("react").JSX.Element;
+/**
+ * A list row with an optional icon tile, a title, a muted second line and
+ * trailing content such as a ToolViewBadge. With `href` the row is a plain link
+ * that navigates the whole page, since a view can't reach your app's router.
+ */
 export declare function ToolViewRow({ icon, title, secondary, trailing, href, ...rest }: {
     icon?: ReactNode;
     title: ReactNode;
     secondary?: ReactNode;
     trailing?: ReactNode;
-    /** A plain anchor: a view lives in its own React root, outside any
-     *  host router, so a row that navigates is a full navigation. */
     href?: string;
 } & Record<`data-${string}`, string | number | undefined>): import("react").JSX.Element;
+/**
+ * Label and value rows, in the order given, for showing a record's properties.
+ */
 export declare function ToolViewFacts({ facts, ...rest }: {
     facts: readonly {
         label: string;
         value: ReactNode;
     }[];
 } & Record<`data-${string}`, string | number | undefined>): import("react").JSX.Element;
+/**
+ * A quiet, muted line inside a card, such as a count or a response status, with
+ * optional `trailing` content on the right.
+ */
 export declare function ToolViewCaption({ children, trailing, ...rest }: {
     children: ReactNode;
     trailing?: ReactNode;
 } & Record<`data-${string}`, string | number | undefined>): import("react").JSX.Element;
+/**
+ * A labelled scrolling region inside a card, up to 18rem tall, for a document,
+ * a diff or other long content; `label` is its accessible name. Extra `data-*`
+ * attributes pass through to the element.
+ */
 export declare function ToolViewBody({ label, children, ...rest }: {
     label: string;
     children: ReactNode;
 } & Record<`data-${string}`, string | number | undefined>): import("react").JSX.Element;
-/** A bounded, scrolling region for a long list inside a card. */
+/**
+ * A scrolling area inside a card, up to 18rem tall, for a long list of rows.
+ * Extra `data-*` attributes pass through to the element.
+ */
 export declare function ToolViewScroll({ children, ...rest }: {
     children: ReactNode;
 } & Record<`data-${string}`, string | number | undefined>): import("react").JSX.Element;
+/**
+ * A small outlined label, usually trailing a ToolViewRow, for a short state
+ * such as "Awaiting approval" or "Not created". Extra `data-*` attributes pass
+ * through to the element.
+ */
 export declare function ToolViewBadge({ children, ...rest }: {
     children: ReactNode;
 } & Record<`data-${string}`, string | number | undefined>): import("react").JSX.Element;
-/** One quiet sentence in the muted register — for what is absent,
- *  degraded, or not renderable, never for invented structure. */
+/**
+ * One muted sentence, for something absent, degraded or not shown, such as the
+ * text from settledOutcomeNoteOf.
+ */
 export declare function ToolViewNote({ children, ...rest }: {
     children: ReactNode;
 } & Record<`data-${string}`, string | number | undefined>): import("react").JSX.Element;
-/** Skeleton lines where the result will land — pending is a shape. */
+/**
+ * Pulsing skeleton lines that hold the place where a result will appear while
+ * the call runs, with no card or border; `lines` defaults to 3. Hidden from
+ * screen readers.
+ */
 export declare function ToolViewBones({ lines, ...rest }: {
     lines?: number;
 } & Record<`data-${string}`, string | number | undefined>): import("react").JSX.Element;
-//# sourceMappingURL=parts.d.ts.map

package/dist/components/tool-views/parts.js

@@ -1,7 +1,6 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { BADGE_CLASS, BODY_REGION_CLASS, BONES_CLASS, BONE_CLASS, CAPTION_ROW_CLASS, CARD_CLASS, CARD_TITLE_CLASS, FACT_LABEL_CLASS, FACT_LIST_CLASS, FACT_ROW_CLASS, FACT_VALUE_CLASS, NOTE_CLASS, ROW_CLASS, ROW_ICON_CLASS, ROW_LINK_CLASS, ROW_SECONDARY_CLASS, ROW_TEXT_CLASS, ROW_TITLE_CLASS, ROW_TRAIL_CLASS, SCROLL_REGION_CLASS, } from "./parts-classes.js";
-/** The small label over a card — or over a skeleton, which draws no card. */
 export function ToolViewTitle({ children }) {
     return _jsx("p", { className: CARD_TITLE_CLASS, children: children });
 }
@@ -21,20 +20,15 @@ export function ToolViewCaption({ children, trailing, ...rest }) {
 export function ToolViewBody({ label, children, ...rest }) {
     return (_jsx("section", { "aria-label": label, className: BODY_REGION_CLASS, ...rest, children: children }));
 }
-/** A bounded, scrolling region for a long list inside a card. */
 export function ToolViewScroll({ children, ...rest }) {
     return (_jsx("div", { className: SCROLL_REGION_CLASS, "data-tf-scroll-region": "", ...rest, children: children }));
 }
 export function ToolViewBadge({ children, ...rest }) {
     return (_jsx("span", { className: BADGE_CLASS, ...rest, children: children }));
 }
-/** One quiet sentence in the muted register — for what is absent,
- *  degraded, or not renderable, never for invented structure. */
 export function ToolViewNote({ children, ...rest }) {
     return (_jsx("p", { className: NOTE_CLASS, ...rest, children: children }));
 }
-/** Skeleton lines where the result will land — pending is a shape. */
 export function ToolViewBones({ lines = 3, ...rest }) {
     return (_jsx("div", { className: BONES_CLASS, "aria-hidden": true, ...rest, children: Array.from({ length: lines }, (_, index) => (_jsx("span", { className: `${BONE_CLASS} ${index === 0 ? "tf:w-1/2" : "tf:w-full"}` }, index))) }));
 }
-//# sourceMappingURL=parts.js.map

package/dist/components/tool-views/questions-view.js

@@ -8,8 +8,6 @@ function renderQuestions({ call }) {
     const receipt = settledWithResult(call) && call.truncated !== true
         ? settledQuestionsReceiptOf(call.toolName, JSON.stringify(call.args), call.resultText)
         : null;
-    // The active QuestionPanel owns unanswered questions. Keep this view
-    // empty until there is a durable answer record to inspect.
     if (receipt === null) {
         if (settledWithResult(call)) {
             root.append(note("No answers are available in this record."));
@@ -29,16 +27,15 @@ function renderQuestions({ call }) {
 function questionSection(question, answer) {
     const section = el("div", "tf:min-w-0 tf:border-t tf:border-tf-border tf:p-4 tf:first:border-t-0");
     const title = el("dt", "");
-    title.append(el("span", "tf:wrap-anywhere tf:text-tf-label tf:font-medium tf:text-tf-foreground", question.heading));
+    title.append(el("span", "tf:wrap-anywhere tf:text-tf-label tf:font-medium tf:text-tf-card-foreground", question.heading));
     const prompt = el("dd", "tf:m-0 tf:mt-1.5 tf:wrap-anywhere tf:whitespace-pre-wrap tf:text-tf-label tf:leading-relaxed tf:text-tf-muted-foreground", question.prompt);
     prompt.dataset.tfElicitationReceiptQuestion = "";
     section.append(title, prompt);
     if (answer !== undefined) {
-        const value = el("dd", "tf:m-0 tf:mt-3 tf:rounded-md tf:bg-tf-muted tf:px-3 tf:py-2.5 tf:wrap-anywhere tf:whitespace-pre-wrap tf:text-tf-label tf:leading-relaxed tf:text-tf-foreground");
+        const value = el("dd", "tf:m-0 tf:mt-3 tf:rounded-md tf:bg-tf-muted tf:px-3 tf:py-2.5 tf:wrap-anywhere tf:whitespace-pre-wrap tf:text-tf-label tf:leading-relaxed tf:text-tf-card-foreground");
         value.dataset.tfElicitationReceiptAnswer = "";
         value.append(el("span", "tf:sr-only", "Answered: "), document.createTextNode(answer));
         section.append(value);
     }
     return section;
 }
-//# sourceMappingURL=questions-view.js.map