@teaflask/assistant 0.0.0 → 0.3.0

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

@@ -0,0 +1,49 @@
+import type { ReactNode } from "react";
+/** The small label over a card — or over a skeleton, which draws no card. */
+export declare function ToolViewTitle({ children }: {
+    children: ReactNode;
+}): import("react").JSX.Element;
+export declare function ToolViewCard({ title, children, ...rest }: {
+    title?: string;
+    children: ReactNode;
+} & Record<`data-${string}`, string | number | undefined>): import("react").JSX.Element;
+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;
+export declare function ToolViewFacts({ facts, ...rest }: {
+    facts: readonly {
+        label: string;
+        value: ReactNode;
+    }[];
+} & Record<`data-${string}`, string | number | undefined>): import("react").JSX.Element;
+export declare function ToolViewCaption({ children, trailing, ...rest }: {
+    children: ReactNode;
+    trailing?: ReactNode;
+} & Record<`data-${string}`, string | number | undefined>): import("react").JSX.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. */
+export declare function ToolViewScroll({ children, ...rest }: {
+    children: ReactNode;
+} & Record<`data-${string}`, string | number | undefined>): import("react").JSX.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. */
+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. */
+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.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parts.d.ts","sourceRoot":"","sources":["../../../src/components/tool-views/parts.tsx"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAyBvC,6EAA6E;AAC7E,wBAAgB,aAAa,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,+BAElE;AAED,wBAAgB,YAAY,CAAC,EAC3B,KAAK,EACL,QAAQ,EACR,GAAG,IAAI,EACR,EAAE;IACD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,SAAS,CAAC;CACrB,GAAG,MAAM,CAAC,QAAQ,MAAM,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,+BASxD;AAED,wBAAgB,WAAW,CAAC,EAC1B,IAAI,EACJ,KAAK,EACL,SAAS,EACT,QAAQ,EACR,IAAI,EACJ,GAAG,IAAI,EACR,EAAE;IACD,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,SAAS,CAAC;IACjB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB;qEACiE;IACjE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,MAAM,CAAC,QAAQ,MAAM,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,+BAwBxD;AAED,wBAAgB,aAAa,CAAC,EAC5B,KAAK,EACL,GAAG,IAAI,EACR,EAAE;IACD,KAAK,EAAE,SAAS;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,SAAS,CAAA;KAAE,EAAE,CAAC;CACvD,GAAG,MAAM,CAAC,QAAQ,MAAM,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,+BAaxD;AAED,wBAAgB,eAAe,CAAC,EAC9B,QAAQ,EACR,QAAQ,EACR,GAAG,IAAI,EACR,EAAE;IACD,QAAQ,EAAE,SAAS,CAAC;IACpB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB,GAAG,MAAM,CAAC,QAAQ,MAAM,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,+BASxD;AAED,wBAAgB,YAAY,CAAC,EAC3B,KAAK,EACL,QAAQ,EACR,GAAG,IAAI,EACR,EAAE;IACD,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,SAAS,CAAC;CACrB,GAAG,MAAM,CAAC,QAAQ,MAAM,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,+BAMxD;AAED,iEAAiE;AACjE,wBAAgB,cAAc,CAAC,EAC7B,QAAQ,EACR,GAAG,IAAI,EACR,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,GAAG,MAAM,CACjC,QAAQ,MAAM,EAAE,EAChB,MAAM,GAAG,MAAM,GAAG,SAAS,CAC5B,+BAMA;AAED,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,EACR,GAAG,IAAI,EACR,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,GAAG,MAAM,CACjC,QAAQ,MAAM,EAAE,EAChB,MAAM,GAAG,MAAM,GAAG,SAAS,CAC5B,+BAMA;AAED;iEACiE;AACjE,wBAAgB,YAAY,CAAC,EAC3B,QAAQ,EACR,GAAG,IAAI,EACR,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,GAAG,MAAM,CACjC,QAAQ,MAAM,EAAE,EAChB,MAAM,GAAG,MAAM,GAAG,SAAS,CAC5B,+BAMA;AAED,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,EAC5B,KAAS,EACT,GAAG,IAAI,EACR,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAAC,QAAQ,MAAM,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,+BAW5E"}

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

@@ -0,0 +1,40 @@
+"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 });
+}
+export function ToolViewCard({ title, children, ...rest }) {
+    return (_jsxs("div", { ...rest, children: [title !== undefined && _jsx(ToolViewTitle, { children: title }), _jsx("div", { className: CARD_CLASS, "data-tf-tool-view-card": "", children: children })] }));
+}
+export function ToolViewRow({ icon, title, secondary, trailing, href, ...rest }) {
+    const content = (_jsxs(_Fragment, { children: [icon !== undefined && _jsx("span", { className: ROW_ICON_CLASS, children: icon }), _jsxs("span", { className: ROW_TEXT_CLASS, children: [_jsx("span", { className: ROW_TITLE_CLASS, children: title }), secondary !== undefined && secondary !== null && (_jsx("span", { className: ROW_SECONDARY_CLASS, children: secondary }))] }), trailing !== undefined && trailing !== null && (_jsx("span", { className: ROW_TRAIL_CLASS, children: trailing }))] }));
+    return href === undefined ? (_jsx("div", { className: ROW_CLASS, ...rest, children: content })) : (_jsx("a", { href: href, className: `${ROW_CLASS} ${ROW_LINK_CLASS}`, ...rest, children: content }));
+}
+export function ToolViewFacts({ facts, ...rest }) {
+    return (_jsx("dl", { className: FACT_LIST_CLASS, ...rest, children: facts.map((fact, index) => (_jsxs("div", { className: FACT_ROW_CLASS, children: [_jsx("dt", { className: FACT_LABEL_CLASS, children: fact.label }), _jsx("dd", { className: FACT_VALUE_CLASS, children: fact.value })] }, index))) }));
+}
+export function ToolViewCaption({ children, trailing, ...rest }) {
+    return (_jsxs("div", { className: CAPTION_ROW_CLASS, ...rest, children: [_jsx("span", { className: "tf:min-w-0", children: children }), trailing !== undefined && trailing !== null && (_jsx("span", { className: "tf:shrink-0", children: trailing }))] }));
+}
+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/parts.js.map

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

package/dist/components/tool-views/questions-view.d.ts

@@ -0,0 +1,2 @@
+export declare const questionsToolView: import("../../headless.js").ToolViewAdapter<Record<string, unknown>, unknown>;
+//# sourceMappingURL=questions-view.d.ts.map

package/dist/components/tool-views/questions-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"questions-view.d.ts","sourceRoot":"","sources":["../../../src/components/tool-views/questions-view.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,iBAAiB,+EAAqC,CAAC"}

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

@@ -0,0 +1,44 @@
+import { settledQuestionsReceiptOf } from "../../core/question-receipt.js";
+import { card, el, note, settledOutcomeNotesOf, settledWithResult, statelessToolView, } from "./view-dom.js";
+export const questionsToolView = statelessToolView(renderQuestions);
+function renderQuestions({ call }) {
+    const root = el("div", "tf:min-w-0");
+    root.dataset.tfQuestionsView = "";
+    root.append(...settledOutcomeNotesOf(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."));
+        }
+        return root;
+    }
+    root.dataset.tfElicitationReceipt = "";
+    root.dataset.tfQuestionsReceipt = "";
+    const answers = new Map(receipt.answers.map((answer) => [answer.id, answer.text]));
+    const list = el("dl", "tf:m-0");
+    receipt.questions.forEach((question) => {
+        list.append(questionSection(question, answers.get(question.id) ?? "Answered."));
+    });
+    root.append(card([list]));
+    return root;
+}
+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));
+    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");
+        value.dataset.tfElicitationReceiptAnswer = "";
+        value.append(el("span", "tf:sr-only", "Answered: "), document.createTextNode(answer));
+        section.append(value);
+    }
+    return section;
+}
+//# sourceMappingURL=questions-view.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"questions-view.js","sourceRoot":"","sources":["../../../src/components/tool-views/questions-view.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAE3E,OAAO,EACL,IAAI,EACJ,EAAE,EACF,IAAI,EACJ,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,eAAe,CAAC;AAEvB,MAAM,CAAC,MAAM,iBAAiB,GAAG,iBAAiB,CAAC,eAAe,CAAC,CAAC;AAEpE,SAAS,eAAe,CAAC,EAAE,IAAI,EAAiB;IAC9C,MAAM,IAAI,GAAG,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;IACrC,IAAI,CAAC,OAAO,CAAC,eAAe,GAAG,EAAE,CAAC;IAClC,IAAI,CAAC,MAAM,CAAC,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5C,MAAM,OAAO,GACX,iBAAiB,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI;QAChD,CAAC,CAAC,yBAAyB,CACvB,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EACzB,IAAI,CAAC,UAAU,CAChB;QACH,CAAC,CAAC,IAAI,CAAC;IACX,qEAAqE;IACrE,2DAA2D;IAC3D,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,IAAI,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC,CAAC;QAChE,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,oBAAoB,GAAG,EAAE,CAAC;IACvC,IAAI,CAAC,OAAO,CAAC,kBAAkB,GAAG,EAAE,CAAC;IACrC,MAAM,OAAO,GAAG,IAAI,GAAG,CACrB,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAC1D,CAAC;IACF,MAAM,IAAI,GAAG,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAChC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE;QACrC,IAAI,CAAC,MAAM,CACT,eAAe,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,WAAW,CAAC,CACnE,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC1B,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,eAAe,CACtB,QAAuB,EACvB,MAA0B;IAE1B,MAAM,OAAO,GAAG,EAAE,CAChB,KAAK,EACL,uEAAuE,CACxE,CAAC;IACF,MAAM,KAAK,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC3B,KAAK,CAAC,MAAM,CACV,EAAE,CACA,MAAM,EACN,wEAAwE,EACxE,QAAQ,CAAC,OAAO,CACjB,CACF,CAAC;IACF,MAAM,MAAM,GAAG,EAAE,CACf,IAAI,EACJ,0HAA0H,EAC1H,QAAQ,CAAC,MAAM,CAChB,CAAC;IACF,MAAM,CAAC,OAAO,CAAC,4BAA4B,GAAG,EAAE,CAAC;IACjD,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC9B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,EAAE,CACd,IAAI,EACJ,iKAAiK,CAClK,CAAC;QACF,KAAK,CAAC,OAAO,CAAC,0BAA0B,GAAG,EAAE,CAAC;QAC9C,KAAK,CAAC,MAAM,CACV,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,YAAY,CAAC,EACtC,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAChC,CAAC;QACF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/components/tool-views/view-dom.d.ts

@@ -0,0 +1,123 @@
+import type { ToolViewAdapter, ToolViewCall, ToolViewProps } from "../../core/tool-view.js";
+import { LABEL_CLASS, PANE_CLASS, PANE_WRAPPER_CLASS } from "./parts-classes.js";
+export { LABEL_CLASS, PANE_CLASS, PANE_WRAPPER_CLASS };
+export declare function el<K extends keyof HTMLElementTagNameMap>(tag: K, className: string, text?: string): HTMLElementTagNameMap[K];
+/** A labeled mono pane — one honest block of recorded text on the muted
+ *  ground, flush with its container: standalone it sits on the row like
+ *  the file-edit view's diff panes; inside a card the caller insets it
+ *  (docs-search). Never a second border. */
+export declare function pane(label: string, text: string): HTMLElement;
+/** A command and its streams as one terminal block — `$ command`, then
+ *  stdout, then stderr (quiet, never failure ink: stderr is routine). */
+export declare function terminal(options: {
+    command: string | null;
+    output?: string;
+    stderr?: string;
+}): HTMLElement;
+/** A bounded, scrolling region for a long list inside a card. */
+export declare function scrollRegion(children: readonly HTMLElement[]): HTMLElement;
+/** The hairline card every built-in composes its content into. */
+export declare function card(children: readonly HTMLElement[], title?: string): HTMLElement;
+/** One list row: an optional icon tile, a title line, a muted second
+ *  line, and trailing content (a badge, a fact). */
+export declare function listRow(options: {
+    title: string;
+    secondary?: string;
+    trailing?: HTMLElement | string;
+    icon?: Element;
+    below?: HTMLElement;
+}): HTMLElement;
+/** Property rows: a muted label column and a value column. */
+export declare function factRows(facts: readonly (readonly [label: string, value: string | HTMLElement])[]): HTMLElement;
+/** A quiet caption row inside a card, with optional trailing content. */
+export declare function captionRow(text: string, trailing?: HTMLElement | string): HTMLElement;
+/** A trailing badge on a list row — the vanilla twin of ToolViewBadge,
+ *  for the wait on a built-in's proposal row. */
+export declare function badge(text: string): HTMLElement;
+/** Skeleton lines where the result will land — pending is a shape. */
+export declare function boneRows(count: number): HTMLElement;
+/** One quiet sentence in the muted register — for what is absent,
+ *  degraded, or not renderable, never for invented structure. */
+export declare function note(text: string): HTMLElement;
+export declare function recordOf(value: unknown): Record<string, unknown> | null;
+export declare function stringOf(value: unknown): string | null;
+/**
+ * The lifecycle factory every built-in rides: `render` is a pure
+ * function of the props, so a full re-render IS the contract's
+ * update-in-place — the state the update law protects is state these
+ * views deliberately don't hold. A throw from `render` propagates as
+ * the adapter's one failure channel and the slot advances a rung.
+ */
+export declare function statelessToolView(render: (props: ToolViewProps) => HTMLElement): ToolViewAdapter;
+/** True when the call settled cleanly with its own recorded output —
+ *  the only state in which a built-in may draw a result shape. */
+export declare function settledWithResult(call: ToolViewCall): boolean;
+/**
+ * The honesty ladder every built-in applies before any success shape:
+ * a call that didn't finish cleanly never wears success furniture, and
+ * a result the transcript doesn't hold is said to be missing, never
+ * invented. The row narrates these states with richer copy of its own
+ * (the pill, the refusal reason, the error pane).
+ *
+ * REACHABILITY, recorded (re-derived from this function's own switch):
+ * the refused, output-error, denied, cancelled, superseded and offloaded
+ * arms are REACHABLE in production — tool-row no longer gates output, so
+ * a view mounts for the call's whole lifecycle while the view model
+ * withholds output on exactly these settles. A still-RUNNING call
+ * renders none of them: input-streaming and input-available break out to
+ * the empty list below. That is the difference from the action view's
+ * deleted ok:false arm, which needed output-available PLUS a failure
+ * envelope — a pairing the producers can never emit under any gating.
+ */
+export declare function settledOutcomeNotesOf(call: ToolViewCall): HTMLElement[];
+/** The same honesty ladder as one sentence, for React hosts that render
+ *  text rather than package DOM — the vocabulary exists once. */
+export declare function settledOutcomeNoteOf(call: ToolViewCall): string | null;
+/** An action call's recorded response: the http_intent success envelope
+ *  `{"ok": true, "result": {status, body, truncated}}` that
+ *  tool_return_of (toolresultv1.py) serializes whole into resultText.
+ *  The core unwrapper hands `call.result` the BODY alone, so the HTTP
+ *  status is recoverable only here. Null for anything that is not
+ *  exactly this envelope (ok:false shapes included) — a view then says
+ *  so, never guesses. Authored knowledge of our own tool's format,
+ *  exported so hosts re-use it instead of respelling the parse. */
+export interface ActionEnvelope {
+    status: number | null;
+    body: unknown;
+    truncated: boolean;
+}
+export declare function actionEnvelopeOf(resultText: string | undefined): ActionEnvelope | null;
+/** A failed action call's recorded reason: the failure envelope
+ *  `{"ok": false, "error": {code, message, detail?}, instruction}` that
+ *  tool_return_of serializes into the call's error text. `detail` is the
+ *  API's own account when the adapter's error carried one
+ *  (execution-kinds.ts ExecutionFailureDetail). Null for any other text
+ *  — the row's own error pane still shows the raw reason. */
+export interface ActionFailure {
+    message: string;
+    detail: {
+        status: number;
+        code: string;
+        fields: {
+            path: string;
+            message: string;
+        }[];
+        /** Problems the API named beyond `fields` — the producer's cap or
+         *  door fit dropped them from the tail (execution-handlers.ts);
+         *  present only when positive, so a partial list never reads whole. */
+        fieldsOmitted?: number;
+    } | null;
+}
+export declare function actionFailureOf(errorText: string | undefined): ActionFailure | null;
+/** The member-facing sentence of a recorded failure: the failure
+ *  envelope's message with its model-facing parts removed — the
+ *  "HTTP 422 CODE — " prefix, the "Field problems: …" clause and the
+ *  "Do not assume …" tail — or the error text itself when it is not the
+ *  envelope. The status, code and fields stay machine facts a view reads
+ *  through actionFailureOf; a row never prints wire vocabulary at a
+ *  member. */
+export declare function humanFailureSentenceOf(errorText: string): string;
+/** A document glyph for a row's icon tile (the package's file mark, as
+ *  an inline SVG so vanilla built-ins carry no icon dependency). */
+export declare function fileGlyph(): SVGElement;
+//# sourceMappingURL=view-dom.d.ts.map

package/dist/components/tool-views/view-dom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-dom.d.ts","sourceRoot":"","sources":["../../../src/components/tool-views/view-dom.ts"],"names":[],"mappings":"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"}