@teaflask/assistant 0.0.0 → 0.3.0

package/dist/components/tool-row.js

@@ -0,0 +1,75 @@
+"use client";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+// The universal process-row grammar: a semantic operation mark
+// (operation-icons.tsx — identity stays visible in every state; completion
+// is quiet, never a universal tick), the headline in muted ink with a
+// shimmer sweep while running, an inline state pill for failure /
+// interruption / the door's refusal / a member's denial / awaiting-input,
+// a chevron; expanding indents the panes under the label column, no card
+// chrome. The row reads the RESOLVED presentation, never the raw display envelope.
+import {} from "../core/tool-call-display.js";
+import { toolCallPresentationOf } from "../core/tool-call-presentation.js";
+import { OperationMark, StatePill } from "./operation-icons.js";
+import { Disclosure, DisclosureChevron } from "./primitives/disclosure.js";
+import { ShimmerText } from "./streaming-states.js";
+import { useToolViewRegistry } from "./tool-view-registry-context.js";
+import { ToolViewIconSlot, ToolViewSlot } from "./tool-view-slot.js";
+import { humanFailureSentenceOf } from "./tool-views/view-dom.js";
+// Tool rows share the activity rail geometry (gap-3, ps-7 body). Answered
+// asks use the same geometry inside their work fold. Summary child positions
+// are contract: mark first, label second (TVC-050/051 measure exactly those
+// children); the pill and chevron follow. Row placement: a HOST-authored
+// view (rungs 1–2) or a decision holds the row open while its turn is
+// current and the call is running or settled clean; released to native at
+// the next user turn. A package built-in or the default reading never opens
+// a row — the host decided the tool was worth a view, the package did not —
+// and a failed, not-run or degraded (truncated, offloaded) row is closed
+// whatever it resolved: the pill names the state, the body is for the member
+// who asks.
+function heldOpenOf(view, toolView, decision) {
+    const hostViewBearing = toolView.views.some((candidate) => candidate.rung <= 2);
+    return (isCleanState(view.state) &&
+        view.offloaded !== true &&
+        (hostViewBearing || decision) &&
+        toolView.call.truncated !== true);
+}
+function isCleanState(state) {
+    return (state === "input-streaming" ||
+        state === "input-available" ||
+        state === "output-available");
+}
+export function ToolRow({ view, awaitingInput = false, decisionBearing, inCurrentTurn = false, }) {
+    // The resolved presentation: the single resolution point — this row
+    // reads slots, never the raw display envelope. The tool-view ladder's
+    // answer (tool-views.md) arrives as the toolView slot: the rung 1–3
+    // candidates plus the assembled call.
+    const presentation = toolCallPresentationOf(view, useToolViewRegistry(), {
+        awaitingDecision: awaitingInput,
+    });
+    const toolView = presentation.toolView;
+    const heldRowOpen = inCurrentTurn &&
+        heldOpenOf(view, toolView, decisionBearing ?? awaitingInput);
+    return (_jsxs(Disclosure, { variant: "bare", open: heldRowOpen || undefined, ...(view.toolCallId !== undefined && view.toolCallId !== ""
+            ? { rootDataAttributes: { "data-tf-tool-call-id": view.toolCallId } }
+            : {}), className: "tf:w-full", summaryClassName: "tf:flex tf:w-fit tf:items-center tf:gap-3 tf:py-1.5 tf:text-tf-label tf:text-tf-muted-foreground tf:hover:text-tf-foreground", bodyClassName: "tf:flex tf:flex-col tf:gap-2 tf:pt-1 tf:pb-2 tf:ps-7", summary: _jsxs(_Fragment, { children: [toolView.icons.length === 0 ? (_jsx(OperationMark, { icon: presentation.icon, status: presentation.status })) : (
+                // A registered icon (tool-views.md: one registration, two
+                // roles) replaces the mark's glyph and nothing else — the
+                // slot keeps the package chrome and this first-child
+                // position stays the TVC-050 contract.
+                _jsx(ToolViewIconSlot, { icons: toolView.icons, call: toolView.call, icon: presentation.icon })), presentation.status === "input-available" ? (_jsx(ShimmerText, { className: "tf:leading-none", children: presentation.headline })) : (_jsx("span", { className: "tf:leading-none", children: presentation.headline })), presentation.status === "output-error" ? (_jsx(StatePill, { destructive: true, children: "Failed" })) : presentation.status === "denied" ? (
+                // The member's own decision: its own word, plain ink —
+                // never "Interrupted" (the wire's cancel stamp, which this
+                // state outranks) and never the door's "Declined".
+                _jsx(StatePill, { children: "Not approved" })) : presentation.status === "cancelled" ||
+                    presentation.status === "superseded" ? (_jsx(StatePill, { children: "Interrupted" })) : presentation.status === "refused" ? (_jsx(StatePill, { children: "Declined" })) : awaitingInput ? (_jsx(StatePill, { children: "Needs input" })) : null, _jsx(DisclosureChevron, { revealOnInteraction: true })] }), children: [_jsx("div", { "data-tf-semantic-view": "", className: "tf:mt-1", children: _jsx(ToolViewSlot, { views: toolView.views, call: toolView.call }) }), view.offloaded === true && (
+            // The offloaded settle: the wire holds the offloader's model-facing
+            // replacement (withheld by the view model); this quiet line is the story.
+            _jsx("p", { className: "tf:text-xs tf:text-tf-muted-foreground", children: "This result was too long to show in full, so the assistant worked from a shortened preview." })), view.refusalText !== undefined && (
+            // The declined reason: the door's own sentence, in the same quiet
+            // register as the offloaded line — never destructive ink.
+            _jsx("p", { "data-tf-refusal-reason": "", className: "tf:text-xs tf:text-tf-muted-foreground", children: view.refusalText })), view.errorText !== undefined && (
+            // The failure's one sentence: the pill already says "Failed", so
+            // the reason reads quietly, with no label and never the wire JSON.
+            _jsx("p", { "data-tf-error-reason": "", className: "tf:text-xs tf:text-tf-muted-foreground", children: humanFailureSentenceOf(view.errorText) }))] }));
+}
+//# sourceMappingURL=tool-row.js.map

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

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

package/dist/components/tool-view-registry-context.d.ts

@@ -0,0 +1,8 @@
+import type { ToolViewRegistry } from "../core/tool-view.js";
+export declare const ToolViewRegistryContext: import("react").Context<Readonly<Record<string, import("../headless.js").ToolViewRegistration>> | null>;
+/** The tolerant read: `undefined` outside a provider, which is what
+ *  keeps bare mounts (tests, fixtures) and registry-less hosts — React
+ *  or script-tag, registering nothing stays fully supported — on
+ *  package defaults everywhere. */
+export declare function useToolViewRegistry(): ToolViewRegistry | undefined;
+//# sourceMappingURL=tool-view-registry-context.d.ts.map

package/dist/components/tool-view-registry-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-view-registry-context.d.ts","sourceRoot":"","sources":["../../src/components/tool-view-registry-context.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAW7D,eAAO,MAAM,uBAAuB,yGAEnC,CAAC;AAEF;;;mCAGmC;AACnC,wBAAgB,mBAAmB,IAAI,gBAAgB,GAAG,SAAS,CAElE"}

package/dist/components/tool-view-registry-context.js

@@ -0,0 +1,19 @@
+"use client";
+import { createContext, useContext } from "react";
+// The provider's tool-view registry channel to the transcript surfaces
+// (tool-views.md). A separate context from the session for the same
+// reason appearance is: hosts write the `toolViews` prop as an inline
+// object literal, and a registry holds adapters — the theme prop's
+// serialize-and-key trick cannot apply, so the registry must be
+// structurally unable to reach the session's memo keys, where a
+// fresh-per-render identity would tear down and rebuild the
+// conversation transport.
+export const ToolViewRegistryContext = createContext(null);
+/** The tolerant read: `undefined` outside a provider, which is what
+ *  keeps bare mounts (tests, fixtures) and registry-less hosts — React
+ *  or script-tag, registering nothing stays fully supported — on
+ *  package defaults everywhere. */
+export function useToolViewRegistry() {
+    return useContext(ToolViewRegistryContext) ?? undefined;
+}
+//# sourceMappingURL=tool-view-registry-context.js.map

package/dist/components/tool-view-registry-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-view-registry-context.js","sourceRoot":"","sources":["../../src/components/tool-view-registry-context.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAIlD,uEAAuE;AACvE,oEAAoE;AACpE,sEAAsE;AACtE,mEAAmE;AACnE,gEAAgE;AAChE,gEAAgE;AAChE,4DAA4D;AAC5D,0BAA0B;AAE1B,MAAM,CAAC,MAAM,uBAAuB,GAAG,aAAa,CAClD,IAAI,CACL,CAAC;AAEF;;;mCAGmC;AACnC,MAAM,UAAU,mBAAmB;IACjC,OAAO,UAAU,CAAC,uBAAuB,CAAC,IAAI,SAAS,CAAC;AAC1D,CAAC"}

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

@@ -0,0 +1,21 @@
+import type { ResolvedToolView, ResolvedToolViewIcon, ToolViewCall } from "../core/tool-view.js";
+import type { ToolCallIcon } from "../core/tool-call-presentation.js";
+/** The row-body slot: the mounted candidate's container, or the rung-4
+ *  terminal. It adds no heading of its own — a view titles itself (the
+ *  package parts carry the card title), so nothing here can claim a
+ *  result that a request-shaped view does not show. */
+export declare function ToolViewSlot({ views, call, }: {
+    views: readonly ResolvedToolView[];
+    call: ToolViewCall;
+}): import("react").JSX.Element;
+/** The operation-mark slot: a registered icon replaces the mark's GLYPH
+ *  and nothing else — the mark's identity, state attribute, ink rules
+ *  and assistive state word stay package-owned (OperationMarkFrame),
+ *  outside anything an adapter can reach. The terminal is the package
+ *  glyph for the resolved icon token. */
+export declare function ToolViewIconSlot({ icons, call, icon, }: {
+    icons: readonly ResolvedToolViewIcon[];
+    call: ToolViewCall;
+    icon: ToolCallIcon;
+}): import("react").JSX.Element;
+//# sourceMappingURL=tool-view-slot.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool-view-slot.d.ts","sourceRoot":"","sources":["../../src/components/tool-view-slot.tsx"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAEV,gBAAgB,EAChB,oBAAoB,EAEpB,YAAY,EAGb,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAsBtE;;;uDAGuD;AACvD,wBAAgB,YAAY,CAAC,EAC3B,KAAK,EACL,IAAI,GACL,EAAE;IACD,KAAK,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACnC,IAAI,EAAE,YAAY,CAAC;CACpB,+BAsBA;AAED;;;;yCAIyC;AACzC,wBAAgB,gBAAgB,CAAC,EAC/B,KAAK,EACL,IAAI,EACJ,IAAI,GACL,EAAE;IACD,KAAK,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACvC,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,YAAY,CAAC;CACpB,+BAuBA"}

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

@@ -0,0 +1,284 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useCallback, useEffect, useRef, useState, } from "react";
+import { OperationGlyph, OperationMarkFrame } from "./operation-icons.js";
+import { TOOL_VIEW_LATE_FAILURE_EVENT } from "./react-tool-view.js";
+import { useOptionalAssistantSession } from "./teaflask-assistant-provider.js";
+import { DefaultToolView } from "./tool-arguments-summary.js";
+import { useLatestRef } from "./use-latest-ref.js";
+import { useResolvedThemeMode } from "./use-resolved-theme-mode.js";
+// The tool-view mount slot: the runtime half of the resolution ladder.
+// The presenter resolved the static candidates (rungs 1–3); this slot
+// mounts the first, delivers prop changes through `update` IN PLACE
+// (never a remount — a view's local UI state must survive a status
+// advance), and on a mount/update throw advances to the rung below —
+// monotonic, so a flaky adapter never flickers back in. Exhausting the
+// candidates lands on rung 4, the package default view, the slot's own
+// terminal (the row has no override).
+//
+// Composition law: everything inside the mount container belongs to the
+// adapter; nothing package-owned lives there. The row's error, refusal
+// and offloaded lines (tool-row.tsx) render OUTSIDE this slot, so neither
+// a hostile adapter nor a throw can remove them.
+/** The row-body slot: the mounted candidate's container, or the rung-4
+ *  terminal. It adds no heading of its own — a view titles itself (the
+ *  package parts carry the card title), so nothing here can claim a
+ *  result that a request-shaped view does not show. */
+export function ToolViewSlot({ views, call, }) {
+    const slotRef = useRef(null);
+    const mountRef = useRef(null);
+    const themeMode = useResolvedThemeMode(slotRef);
+    const props = { call, context: { themeMode } };
+    const active = useMountedAdapter(views, props, mountRef);
+    return (_jsx("div", { ref: slotRef, "data-tf-tool-view": active?.key ?? "", children: active !== undefined ? (
+        // data-tf-host-view marks the HOST's subtree: the sheet's
+        // border/box reset excludes everything under it, so a host
+        // utility on the view's own elements wins — the widget must not
+        // out-cascade its documented extension point. The row body's
+        // compact register rides the mount node, so a host view inherits
+        // the transcript's size and leading by setting nothing of its own
+        // (the inherit-don't-specify law).
+        _jsx("div", { ref: mountRef, "data-tf-host-view": "", className: "tf:text-xs" })) : (_jsx(DefaultToolView, { call: call, context: { themeMode } })) }));
+}
+/** The operation-mark slot: a registered icon replaces the mark's GLYPH
+ *  and nothing else — the mark's identity, state attribute, ink rules
+ *  and assistive state word stay package-owned (OperationMarkFrame),
+ *  outside anything an adapter can reach. The terminal is the package
+ *  glyph for the resolved icon token. */
+export function ToolViewIconSlot({ icons, call, icon, }) {
+    const mountRef = useRef(null);
+    const themeMode = useResolvedThemeMode(mountRef);
+    const props = { call, context: { themeMode } };
+    const active = useMountedAdapter(icons, props, mountRef);
+    return (_jsx(OperationMarkFrame, { status: call.status, children: active !== undefined ? (
+        // aria-hidden like every package glyph (OperationGlyph): the
+        // mark's assistive content is the frame's sr-only state word,
+        // package-owned — an icon adapter mounting text or a titled SVG
+        // must not join the row summary's accessible name beside it.
+        _jsx("span", { ref: mountRef, "aria-hidden": true, "data-tf-host-view": "", "data-tf-tool-view-icon": active.key })) : (_jsx(OperationGlyph, { icon: icon })) }));
+}
+/**
+ * The shared adapter lifecycle: mount once, update in place, destroy on
+ * unmount, advance on failure. Effects key on the ADAPTER's identity
+ * (registrations live at module scope by contract), never on the
+ * candidate wrapper the presenter rebuilds per render. Failures are
+ * tracked by adapter identity, never by position, and the failed set only
+ * grows within a mount. The failure census and the resolution-change
+ * census: docs/transcript-surfaces.md, "The tool-view mount slot".
+ */
+function useMountedAdapter(candidates, props, nodeRef) {
+    const [failedAdapters, setFailedAdapters] = useState(EMPTY_FAILED);
+    const active = candidates.find((candidate) => !failedAdapters.has(candidate.adapter));
+    const adapter = active?.adapter;
+    // Tolerant on purpose: fixture and bare test mounts have no session;
+    // failures then reach only the console, while a real embed's land on
+    // the host's onError — observable to developers, no stack traces
+    // shown to end users.
+    const session = useOptionalAssistantSession();
+    const reportErrorRef = useLatestRef(session?.reportError);
+    // The key NAMES the failing view in reports; it must never be an
+    // ADVANCE signal. One adapter registered under two keys (the README's
+    // own double-registration shape) re-resolves from rung 2 to rung 1
+    // when the wire ref lands late — same adapter, new key — and a key
+    // dependency on useAdapterMount would destroy and remount the view,
+    // discarding exactly the local UI state that update-in-place exists
+    // to preserve. It rides the mount record instead, written at commit
+    // time, so reports name the currently-resolved key.
+    const heldRef = useRef({
+        instance: null,
+        deliveredProps: null,
+        props,
+        key: active?.key,
+    });
+    // ONE report-clear-advance path for every failure phase in the
+    // FAILURE CENSUS: report to the host, clear the failed adapter's
+    // debris, drop the mounted instance, and skip the adapter everywhere
+    // it resolves. The WeakSet dedupes per adapter object — a late event
+    // and a straggling stale throw must not double-report. What keeps a
+    // failed adapter from being reached twice is the INSTANCE DROP here:
+    // two commits can queue two deliveries while the instance is still
+    // live (flushSync ×2 before any drain), and the first delivery's
+    // catch nulls the instance, so the second returns at its null check.
+    // The failure state applying before any later commit — whose cleanup
+    // also nulls the mount — is the belt on top, not the load-bearing
+    // guard.
+    const reportedFailuresRef = useRef(new WeakSet());
+    const advancePast = useCallback((failedAdapter, error) => {
+        if (reportedFailuresRef.current.has(failedAdapter)) {
+            return;
+        }
+        reportedFailuresRef.current.add(failedAdapter);
+        _reportThrow(heldRef.current.key ?? "", error, reportErrorRef.current);
+        nodeRef.current?.replaceChildren();
+        heldRef.current.instance = null;
+        heldRef.current.deliveredProps = null;
+        setFailedAdapters((previous) => {
+            if (previous.has(failedAdapter)) {
+                return previous;
+            }
+            const next = new Set(previous);
+            next.add(failedAdapter);
+            return next;
+        });
+    }, [nodeRef, reportErrorRef]);
+    useAdapterMount(adapter, nodeRef, heldRef, advancePast);
+    useAdapterDelivery(adapter, active?.key, props, heldRef, advancePast);
+    return active;
+}
+const EMPTY_FAILED = new Set();
+/** Mount and destroy, one adapter at a time. Every adapter call is
+ *  deferred ONE microtask past the React commit: the React sugar's
+ *  mount/update is a flushSync render into a nested root and its destroy
+ *  is a root unmount, and React forbids both while its own commit is
+ *  still on the stack (an effect or a cleanup). The microtask runs
+ *  before the member can interact, and the relative order — destroy
+ *  before the next mount — rides the queue's FIFO. */
+function useAdapterMount(adapter, nodeRef, heldRef, advancePast) {
+    useEffect(() => {
+        const node = nodeRef.current;
+        // The record object is the slot's for its whole lifetime (only its
+        // fields change), so the cleanup reads it directly.
+        const held = heldRef.current;
+        if (adapter === undefined || node === null) {
+            return;
+        }
+        let cancelled = false;
+        let instance = null;
+        // The React sugar's self-scheduled-render failure channel (failure
+        // census case 5): dispatched on the mount container, the one object
+        // the sugar and this slot share.
+        const onLateFailure = (event) => {
+            advancePast(adapter, event.detail);
+        };
+        node.addEventListener(TOOL_VIEW_LATE_FAILURE_EVENT, onLateFailure);
+        queueMicrotask(() => {
+            if (cancelled) {
+                return;
+            }
+            try {
+                instance = adapter.mount(node, held.props);
+                held.instance = instance;
+                held.deliveredProps = held.props;
+            }
+            catch (error) {
+                advancePast(adapter, error);
+            }
+        });
+        return () => {
+            cancelled = true;
+            node.removeEventListener(TOOL_VIEW_LATE_FAILURE_EVENT, onLateFailure);
+            held.instance = null;
+            held.deliveredProps = null;
+            // Captured NOW, not at destroy time: cleanups run before the next
+            // commit's create-phase effects, but the deferred destroy below
+            // runs after them — by then the record already names the NEXT
+            // resolution (or "" at the terminal), and the log would blame the
+            // wrong view. This cleanup still tracks a re-key: the record holds
+            // whatever key this adapter was last resolved under.
+            const destroyedKey = held.key ?? "";
+            queueMicrotask(() => {
+                if (instance === null) {
+                    return;
+                }
+                try {
+                    instance.destroy();
+                }
+                catch (error) {
+                    console.error(`[teaflask-assistant] The tool view "${destroyedKey}" threw on destroy.`, error);
+                }
+                node.replaceChildren();
+            });
+        };
+        // Neither the cursor nor the KEY is in the deps, ON PURPOSE: the
+        // adapter's identity is the ONLY advance signal. An advance always changes `adapter` by
+        // construction (a failed adapter is skipped at every position it
+        // occupies), and a key change with an unchanged adapter — the late
+        // wire ref re-resolving one double-registered adapter from rung 2
+        // to rung 1 — is a re-labelling, not a reason to destroy a mounted
+        // view.
+    }, [adapter, advancePast, heldRef, nodeRef]);
+}
+/** Every commit after the mount delivers the LATEST committed props
+ *  through `update` — in place, never a remount. The delivery guard is
+ *  STRUCTURAL: the presenter mints a fresh call per invocation and this
+ *  slot a fresh props object per render, so an object-identity guard is
+ *  dead by construction — it would suppress only the mount's own
+ *  duplicate and hand every mounted view an update per streamed token
+ *  (with the React sugar, a synchronous render into a nested root per
+ *  token, on calls that already settled). */
+function useAdapterDelivery(adapter, key, props, heldRef, advancePast) {
+    useEffect(() => {
+        const held = heldRef.current;
+        held.props = props;
+        held.key = key;
+        if (adapter === undefined) {
+            return;
+        }
+        queueMicrotask(() => {
+            const instance = held.instance;
+            if (instance === null) {
+                return;
+            }
+            const latest = held.props;
+            const delivered = held.deliveredProps;
+            if (delivered !== null && _sameDelivery(delivered, latest)) {
+                return;
+            }
+            held.deliveredProps = latest;
+            try {
+                instance.update(latest);
+            }
+            catch (error) {
+                advancePast(adapter, error);
+            }
+        });
+    });
+}
+/**
+ * "Nothing a view can observe changed." The field set rests on three
+ * premises — `result`/`truncated` derive from `resultText` (lazy
+ * accessors over it, so the guard compares the source text and never
+ * forces the structuring parse); `args` is identity-stable across
+ * re-renders with unchanged source (the IDENTITY LAW); the schema refs
+ * are identity-stable per source — each stated in
+ * docs/transcript-surfaces.md, "The delivery guard's premises".
+ */
+function _sameDelivery(previous, next) {
+    const before = previous.call;
+    const after = next.call;
+    return (previous.context.themeMode === next.context.themeMode &&
+        before.toolName === after.toolName &&
+        before.toolCallId === after.toolCallId &&
+        before.status === after.status &&
+        before.awaitingDecision === after.awaitingDecision &&
+        before.resultText === after.resultText &&
+        before.offloaded === after.offloaded &&
+        before.errorText === after.errorText &&
+        before.refusalText === after.refusalText &&
+        before.argsSchema === after.argsSchema &&
+        before.resultSchema === after.resultSchema &&
+        _shallowRecordEqual(before.args, after.args));
+}
+function _shallowRecordEqual(before, after) {
+    if (before === after) {
+        return true;
+    }
+    const keys = Object.keys(before);
+    if (keys.length !== Object.keys(after).length) {
+        return false;
+    }
+    for (const key of keys) {
+        if (!Object.prototype.hasOwnProperty.call(after, key) ||
+            before[key] !== after[key]) {
+            return false;
+        }
+    }
+    return true;
+}
+function _reportThrow(key, error, reportError) {
+    // The host's observer hears it, and the console names the view for
+    // whoever is actually debugging the page.
+    reportError?.(error instanceof Error ? error : new Error(String(error)));
+    console.error(`[teaflask-assistant] The tool view "${key}" threw; the next resolution took over.`, error);
+}
+//# sourceMappingURL=tool-view-slot.js.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"action-view.d.ts","sourceRoot":"","sources":["../../../src/components/tool-views/action-view.ts"],"names":[],"mappings":"AA+CA,eAAO,MAAM,cAAc,+EAAmC,CAAC"}

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

@@ -0,0 +1,151 @@
+// teaflask.action — the package's one view for every `action__{slug}`
+// tool (tool-views.md, rung 3): customer HTTP actions are structurally
+// our tools — generated from the catalog, their arguments always the
+// same three-key envelope {path_params, query, body} — so one shipped
+// view renders any org's action, in every host, with zero customer
+// frontend work. It reads the recorded call and nothing else: the
+// method and path template ride only the execution-request marker, not
+// the call's bounded props, so they are deliberately not shown — a
+// built-in gets no privileged data. Producer transforms and argument
+// ledger: docs/tool-view-ledgers.md. Arm reachability and the two
+// truncation channels: the tool-view arm-reachability record.
+//   settledOutcomeNotesOf arms — REACHABLE: tool-row no longer gates
+//     output, so a refused, errored (output-error), denied, cancelled,
+//     superseded or offloaded rung-3 call renders its arm in production;
+//     a still-RUNNING call renders none (input-streaming/input-available
+//     break out to []).
+//   resultText === undefined early return — unreachable today (its call
+//     site is guarded by settledWithResult); kept as totality: a view
+//     never throws on posed props.
+import { prettyPrintParameters } from "../pretty-print.js";
+import { CARD_BLOCK_CLASS } from "./parts-classes.js";
+import { actionEnvelopeOf, actionFailureOf, captionRow, card, el, factRows, note, recordOf, scrollRegion, settledOutcomeNotesOf, settledWithResult, statelessToolView, } from "./view-dom.js";
+const REQUEST_SECTIONS = [
+    ["path_params", "Path parameters"],
+    ["query", "Query"],
+    ["body", "Body"],
+];
+const VALUE_PANE_CLASS = "tf:m-0 tf:whitespace-pre-wrap tf:font-mono tf:text-xs tf:text-tf-foreground";
+export const actionToolView = statelessToolView(_renderAction);
+function _renderAction({ call }) {
+    const root = el("div", "tf:flex tf:flex-col tf:gap-2");
+    root.dataset.tfActionView = "";
+    const sections = [];
+    for (const [key, label] of REQUEST_SECTIONS) {
+        const value = call.args[key];
+        if (value === undefined || value === null) {
+            continue;
+        }
+        // An empty record is the same absence the argument ledger already
+        // describes — a labeled section holding "{}" would be a content-free
+        // frame. An empty ARRAY body still renders: "[]" is a value the
+        // customer's endpoint received.
+        const record = recordOf(value);
+        if (record !== null && Object.keys(record).length === 0) {
+            continue;
+        }
+        sections.push(captionRow(label), _valueRows(value));
+    }
+    if (sections.length > 0) {
+        root.append(card(sections));
+    }
+    root.append(...settledOutcomeNotesOf(call));
+    if (call.status === "output-error") {
+        _appendFieldProblems(root, call);
+    }
+    if (settledWithResult(call)) {
+        _appendResponse(root, call);
+    }
+    return root;
+}
+/** A failure's per-field problems as property rows, the one structured
+ *  fact a failed action carries: the row beside this view already says
+ *  Failed and the human reason, so the view adds the fields alone —
+ *  never the status or error code. Nothing when the API named none. */
+function _appendFieldProblems(root, call) {
+    const detail = actionFailureOf(call.errorText)?.detail;
+    const fields = detail?.fields ?? [];
+    if (fields.length === 0) {
+        return;
+    }
+    const rows = factRows(fields.map((field) => [field.path === "" ? "—" : field.path, field.message]));
+    rows.dataset.tfActionFieldProblems = "";
+    const parts = [captionRow("Field problems"), rows];
+    const omitted = detail?.fieldsOmitted ?? 0;
+    if (omitted > 0) {
+        // The API named more than the record carries: say so, never let a
+        // partial list read as the whole.
+        const more = captionRow(`${String(omitted)} more ${omitted === 1 ? "problem" : "problems"} not listed here.`);
+        more.dataset.tfActionFieldProblemsOmitted = String(omitted);
+        parts.push(more);
+    }
+    root.append(card(parts));
+}
+/** A record becomes property rows (one per top-level key, nested values
+ *  pretty-printed); anything else — an array, a scalar — is one
+ *  pretty-printed block on the same card-child grammar as the rows: the
+ *  hairline above, the rows' inset. Either rides in a bounded scrolling
+ *  well: a body can run to the door's 20k, and a value that tall would
+ *  be the transcript's height, not a card's. */
+function _valueRows(value) {
+    const record = recordOf(value);
+    if (record !== null) {
+        return scrollRegion([
+            factRows(Object.entries(record).map(([key, entry]) => [key, _valueOf(entry)])),
+        ]);
+    }
+    const wrapper = el("div", CARD_BLOCK_CLASS);
+    wrapper.dataset.tfActionValueBlock = "";
+    wrapper.append(el("pre", VALUE_PANE_CLASS, prettyPrintParameters(value)));
+    return scrollRegion([wrapper]);
+}
+function _valueOf(value) {
+    if (typeof value === "string") {
+        return value === "" ? "—" : value;
+    }
+    if (typeof value === "number" ||
+        typeof value === "boolean" ||
+        typeof value === "bigint") {
+        return String(value);
+    }
+    if (value === null || value === undefined) {
+        return "—";
+    }
+    return el("pre", VALUE_PANE_CLASS, prettyPrintParameters(value));
+}
+function _appendResponse(root, call) {
+    if (call.resultText === undefined) {
+        return;
+    }
+    const envelope = actionEnvelopeOf(call.resultText);
+    if (envelope === null) {
+        // Covers the wire's 20k clip too: `call.truncated` is set only by a
+        // WELL-FORMED envelope whose result.truncated is true — which by
+        // construction parsed — so "unparseable but flagged truncated"
+        // cannot co-occur and earns no arm of its own.
+        root.append(note("The response couldn't be read as an action result and isn't rendered."));
+        return;
+    }
+    const rows = [];
+    let status;
+    if (envelope.status !== null) {
+        status = el("span", envelope.status >= 400
+            ? "tf:font-medium tf:text-tf-destructive"
+            : "tf:text-tf-muted-foreground", `HTTP ${String(envelope.status)}`);
+        status.dataset.tfActionStatus = String(envelope.status);
+    }
+    rows.push(captionRow(envelope.truncated ? "Response (truncated)" : "Response", status));
+    if (envelope.truncated) {
+        rows.push(captionRow("The response body was truncated by the client to fit the size cap."));
+    }
+    if (envelope.body === undefined ||
+        envelope.body === null ||
+        envelope.body === "") {
+        rows.push(captionRow("Empty response body."));
+    }
+    else {
+        rows.push(_valueRows(envelope.body));
+    }
+    root.append(card(rows));
+}
+//# sourceMappingURL=action-view.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"action-view.js","sourceRoot":"","sources":["../../../src/components/tool-views/action-view.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,uEAAuE;AACvE,qEAAqE;AACrE,sEAAsE;AACtE,mEAAmE;AACnE,kEAAkE;AAClE,uEAAuE;AACvE,mEAAmE;AACnE,qEAAqE;AACrE,kEAAkE;AAClE,8DAA8D;AAC9D,qEAAqE;AACrE,uEAAuE;AACvE,yEAAyE;AACzE,yEAAyE;AACzE,wBAAwB;AACxB,wEAAwE;AACxE,sEAAsE;AACtE,mCAAmC;AAGnC,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,IAAI,EACJ,EAAE,EACF,QAAQ,EACR,IAAI,EACJ,QAAQ,EACR,YAAY,EACZ,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,eAAe,CAAC;AAEvB,MAAM,gBAAgB,GAAG;IACvB,CAAC,aAAa,EAAE,iBAAiB,CAAC;IAClC,CAAC,OAAO,EAAE,OAAO,CAAC;IAClB,CAAC,MAAM,EAAE,MAAM,CAAC;CACR,CAAC;AAEX,MAAM,gBAAgB,GACpB,6EAA6E,CAAC;AAEhF,MAAM,CAAC,MAAM,cAAc,GAAG,iBAAiB,CAAC,aAAa,CAAC,CAAC;AAE/D,SAAS,aAAa,CAAC,EAAE,IAAI,EAAiB;IAC5C,MAAM,IAAI,GAAG,EAAE,CAAC,KAAK,EAAE,8BAA8B,CAAC,CAAC;IACvD,IAAI,CAAC,OAAO,CAAC,YAAY,GAAG,EAAE,CAAC;IAC/B,MAAM,QAAQ,GAAkB,EAAE,CAAC;IACnC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,gBAAgB,EAAE,CAAC;QAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAC1C,SAAS;QACX,CAAC;QACD,kEAAkE;QAClE,qEAAqE;QACrE,gEAAgE;QAChE,gCAAgC;QAChC,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC/B,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxD,SAAS;QACX,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;IACtD,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC9B,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5C,IAAI,IAAI,CAAC,MAAM,KAAK,cAAc,EAAE,CAAC;QACnC,oBAAoB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;IACD,IAAI,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5B,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;uEAGuE;AACvE,SAAS,oBAAoB,CAAC,IAAiB,EAAE,IAAkB;IACjE,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IACvD,MAAM,MAAM,GAAG,MAAM,EAAE,MAAM,IAAI,EAAE,CAAC;IACpC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO;IACT,CAAC;IACD,MAAM,IAAI,GAAG,QAAQ,CACnB,MAAM,CAAC,GAAG,CACR,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAU,CAC1E,CACF,CAAC;IACF,IAAI,CAAC,OAAO,CAAC,qBAAqB,GAAG,EAAE,CAAC;IACxC,MAAM,KAAK,GAAG,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,IAAI,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,MAAM,EAAE,aAAa,IAAI,CAAC,CAAC;IAC3C,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;QAChB,kEAAkE;QAClE,kCAAkC;QAClC,MAAM,IAAI,GAAG,UAAU,CACrB,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,mBAAmB,CACrF,CAAC;QACF,IAAI,CAAC,OAAO,CAAC,4BAA4B,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;QAC5D,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;AAC3B,CAAC;AAED;;;;;gDAKgD;AAChD,SAAS,UAAU,CAAC,KAAc;IAChC,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC/B,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,OAAO,YAAY,CAAC;YAClB,QAAQ,CACN,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CACxB,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAU,CAClD,CACF;SACF,CAAC,CAAC;IACL,CAAC;IACD,MAAM,OAAO,GAAG,EAAE,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC;IAC5C,OAAO,CAAC,OAAO,CAAC,kBAAkB,GAAG,EAAE,CAAC;IACxC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC1E,OAAO,YAAY,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;IACpC,CAAC;IACD,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAO,KAAK,KAAK,SAAS;QAC1B,OAAO,KAAK,KAAK,QAAQ,EACzB,CAAC;QACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IACD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,EAAE,CAAC,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,CAAC,KAAK,CAAC,CAAC,CAAC;AACnE,CAAC;AAED,SAAS,eAAe,CAAC,IAAiB,EAAE,IAAkB;IAC5D,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QAClC,OAAO;IACT,CAAC;IACD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACnD,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtB,oEAAoE;QACpE,iEAAiE;QACjE,+DAA+D;QAC/D,+CAA+C;QAC/C,IAAI,CAAC,MAAM,CACT,IAAI,CACF,uEAAuE,CACxE,CACF,CAAC;QACF,OAAO;IACT,CAAC;IACD,MAAM,IAAI,GAAkB,EAAE,CAAC;IAC/B,IAAI,MAA+B,CAAC;IACpC,IAAI,QAAQ,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;QAC7B,MAAM,GAAG,EAAE,CACT,MAAM,EACN,QAAQ,CAAC,MAAM,IAAI,GAAG;YACpB,CAAC,CAAC,uCAAuC;YACzC,CAAC,CAAC,6BAA6B,EACjC,QAAQ,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAClC,CAAC;QACF,MAAM,CAAC,OAAO,CAAC,cAAc,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC1D,CAAC;IACD,IAAI,CAAC,IAAI,CACP,UAAU,CACR,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,UAAU,EACxD,MAAM,CACP,CACF,CAAC;IACF,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;QACvB,IAAI,CAAC,IAAI,CACP,UAAU,CACR,oEAAoE,CACrE,CACF,CAAC;IACJ,CAAC;IACD,IACE,QAAQ,CAAC,IAAI,KAAK,SAAS;QAC3B,QAAQ,CAAC,IAAI,KAAK,IAAI;QACtB,QAAQ,CAAC,IAAI,KAAK,EAAE,EACpB,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,sBAAsB,CAAC,CAAC,CAAC;IAChD,CAAC;SAAM,CAAC;QACN,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IACvC,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAC1B,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"command-view.d.ts","sourceRoot":"","sources":["../../../src/components/tool-views/command-view.ts"],"names":[],"mappings":"AAqCA,eAAO,MAAM,eAAe,+EAAoC,CAAC"}