@nxisai/agent-harness 0.6.0 → 0.8.0

package/dist/ui/agent-fullscreen.js

@@ -34,12 +34,17 @@ import { AgentHarness, isAbort } from '../harness/harness.js';
 import { WebMcpTools } from '../harness/tools/webmcp.js';
 import { extractResult, proseAnswer, missingRequired, toolSchema, } from '../harness/tools/schema.js';
 import { connectTools } from '../harness/tools/source.js';
-import { handoffFor, isSiteTool, withoutSiteSuffix, HANDOFF_RESULT, } from '../harness/tools/action-tools.js';
+import { chooserOf, formOptions, formsFor, handoffFor, isSiteTool, withoutSiteSuffix, HANDOFF_RESULT, } from '../harness/tools/action-tools.js';
+import { resolveSlots } from '../harness/slots.js';
+import { isHandoffTool } from '../handoff/tools.js';
+import { actionCard, fieldLabel, fieldsFromSlots, ACTION_CARD_CSS, } from './action-card.js';
+import { resultsAnswer, RESULTS_ANSWER_CSS } from './result-pick.js';
+import { extractRecords, openStatus, recordFacts } from '../harness/records.js';
 import { resumePendingAction } from '../harness/tools/resume.js';
 import { savePendingVisit, setConversationSource, takePendingVisit } from '../harness/tools/pending-action.js';
 import { pageForEntity } from '../harness/tools/site-pages.js';
 import { OPEN_PAGE_TOOL } from '../harness/tools/open-page.js';
-import { onJourneyChange, recordStep, restoreJourney } from '../harness/steps.js';
+import { currentJourney, onJourneyChange, recordStep, restoreJourney } from '../harness/steps.js';
 import { viewJourney } from './journey.js';
 import { AgentCoordinator } from '../harness/router/coordinator.js';
 import { HandoffController, isHandoffOver, } from '../handoff/controller.js';
@@ -78,6 +83,11 @@ const fmt = (n) => n.toLocaleString();
  * be disabled under `prefers-reduced-motion` while the bubble still reads as
  * pending. The label and byte spans are filled per phase and hidden while empty.
  */
+/**
+ * How long the running-step line stays once the conversation moves on past
+ * its card. A glance's worth: long enough to notice and open it.
+ */
+const JSTATUS_TIMEOUT_MS = 10000;
 const THINKING_MARKUP = '<span class="think-row">' +
     '<span class="think-dots" aria-hidden="true"><i></i><i></i><i></i></span>' +
     '<span class="think-label"></span>' +
@@ -245,6 +255,12 @@ class NxisAgentFullscreen extends HTMLElement {
         };
         /** Watches whether the running journey's card is on screen. */
         this._journeyObserver = null;
+        /** The journey the status line is about, while one is running. */
+        this._jstatusJourney = null;
+        /** Journeys whose status line was opened once or timed out: it does not come back. */
+        this._jstatusDismissed = new Set();
+        /** Dismisses the status line a while after the thread moves on past the card. */
+        this._jstatusTimer = null;
         /** Built only when the host defines agents — otherwise there is one harness. */
         this._coordinator = null;
         this._agentDefs = null;
@@ -252,6 +268,14 @@ class NxisAgentFullscreen extends HTMLElement {
         this._fallbackAgent = '';
         /** The live ask/confirm surface, if one is open. */
         this._prompt = null;
+        /**
+         * The action card still waiting on the visitor or a result, and what it can
+         * do: the harness's ask or confirm request, or, after a page change, a call
+         * of the widget's own.
+         */
+        this._live = null;
+        /** Handoff targets as the relay last reported them, for a card's availability line. */
+        this._handoffTargets = new Map();
         this._persistPrefs = false;
         this._systemPrompt = DEFAULT_SYSTEM_PROMPT;
         this._suggestions = DEFAULT_SUGGESTIONS;
@@ -349,13 +373,7 @@ class NxisAgentFullscreen extends HTMLElement {
         this._buildAgents();
         // The element renders; the harness decides. Everything from choosing a
         // tool to running it happens behind harness.turn().
-        this._harness = new AgentHarness({
-            provider: this.provider,
-            toolSource: this.toolSource,
-            renderer: this._renderer(),
-            profile: (schema) => this._profileForSchema(schema),
-            onMessages: () => this._saveConversations(),
-        });
+        this._harness = this._singleHarness();
         // Preferences are supplied by the host page through `element.preferences`.
         // Anything a previous build persisted is picked up so upgrading does not
         // silently drop a user's saved details; `persist` then stays true so they
@@ -387,6 +405,8 @@ class NxisAgentFullscreen extends HTMLElement {
         this._els.jstatus.addEventListener('click', () => {
             const cards = this._els.thread.querySelectorAll('.journey.is-running');
             cards[cards.length - 1]?.scrollIntoView({ block: 'nearest', behavior: 'smooth' });
+            // One look is what it is for; after that it would only be in the way.
+            this._dismissJourneyStatus();
         });
         // Whoever builds the tools, a call that leaves this page reports back to
         // the thread it was made in.
@@ -482,6 +502,7 @@ class NxisAgentFullscreen extends HTMLElement {
         this._offJourney = null;
         this._journeyObserver?.disconnect();
         this._journeyObserver = null;
+        this._clearJourneyStatusTimer();
         // Streams stop with the element; the handoff itself stays saved, and resumes when it returns.
         this._handoff?.dispose();
     }
@@ -667,8 +688,13 @@ class NxisAgentFullscreen extends HTMLElement {
                 this._els.thread.appendChild(this._resultsEl(it));
             else if (it.kind === 'metrics')
                 this._els.thread.appendChild(this._metricsEl(it));
-            else if (it.kind === 'journey')
-                this._els.thread.appendChild(this._journeyEl(it));
+            else if (it.kind === 'journey') {
+                // A request drawn as an action card shows its own steps.
+                if (!conv.items.some((a) => a.kind === 'action' && a.id === it.id))
+                    this._els.thread.appendChild(this._journeyEl(it));
+            }
+            else if (it.kind === 'action')
+                this._paintAction(it);
             else if (it.kind === 'remote' || it.kind === 'handoff')
                 this._paintHandoffItem(it);
         }
@@ -1038,6 +1064,14 @@ class NxisAgentFullscreen extends HTMLElement {
             item = { kind: 'journey', id: view.id, steps: all };
             conv.items.push(item);
         }
+        // A request with an action card: the steps belong in the card.
+        const action = conv.items.find((it) => it.kind === 'action' && it.id === view.id);
+        if (action) {
+            this._actionFollows(action, all);
+            this._watchRunningJourney();
+            this._saveConversations();
+            return;
+        }
         if (conv.id === this._activeId && this._els?.thread) {
             const fresh = this._journeyEl(item);
             const old = this._els.thread.querySelector(`[data-journey="${CSS.escape(view.id)}"]`);
@@ -1071,7 +1105,12 @@ class NxisAgentFullscreen extends HTMLElement {
             return;
         const cards = this._els.thread.querySelectorAll('.journey.is-running');
         const card = cards[cards.length - 1];
-        if (!card || typeof IntersectionObserver === 'undefined') {
+        const id = card?.dataset.journey ?? null;
+        if (id !== this._jstatusJourney) {
+            this._clearJourneyStatusTimer();
+            this._jstatusJourney = id;
+        }
+        if (!card || !id || this._jstatusDismissed.has(id) || typeof IntersectionObserver === 'undefined') {
             bar.hidden = true;
             return;
         }
@@ -1081,6 +1120,37 @@ class NxisAgentFullscreen extends HTMLElement {
         }, { root: this._els.thread, threshold: 0.2 });
         this._journeyObserver.observe(card);
     }
+    /**
+     * The thread grew: start the clock on the status line.
+     *
+     * A journey can stay running while the conversation goes on without it, and a
+     * line that spins through all of that says nothing. So once new messages
+     * arrive, the line gets a while longer, then goes.
+     */
+    _noteThreadGrew() {
+        const id = this._jstatusJourney;
+        if (!id || this._jstatusTimer || this._jstatusDismissed.has(id))
+            return;
+        this._jstatusTimer = setTimeout(() => {
+            this._jstatusTimer = null;
+            this._dismissJourneyStatus();
+        }, JSTATUS_TIMEOUT_MS);
+    }
+    /** Hide the status line for the running journey, for good. */
+    _dismissJourneyStatus() {
+        this._clearJourneyStatusTimer();
+        if (this._jstatusJourney)
+            this._jstatusDismissed.add(this._jstatusJourney);
+        this._journeyObserver?.disconnect();
+        this._journeyObserver = null;
+        if (this._els?.jstatus)
+            this._els.jstatus.hidden = true;
+    }
+    _clearJourneyStatusTimer() {
+        if (this._jstatusTimer)
+            clearTimeout(this._jstatusTimer);
+        this._jstatusTimer = null;
+    }
     _paintToolResult(name, text, isError) {
         this._clearEmpty();
         const el = this._toolEl(name, text, isError);
@@ -1137,6 +1207,7 @@ class NxisAgentFullscreen extends HTMLElement {
         const el = this._paintMsg(role, text, conv.items.length - 1);
         this._saveConversations();
         this._scroll();
+        this._noteThreadGrew();
         return el;
     }
     /**
@@ -1156,6 +1227,7 @@ class NxisAgentFullscreen extends HTMLElement {
         // without the focus moving to it.
         el.setAttribute('aria-live', 'polite');
         this._scroll();
+        this._noteThreadGrew();
         const setLabel = (label) => {
             const node = el.querySelector('.think-label');
             if (node)
@@ -1298,11 +1370,13 @@ class NxisAgentFullscreen extends HTMLElement {
             message: (role, text) => this._appendMsg(role, text),
             streaming: () => this._appendStreaming(),
             status: (text, isError) => this._setStatus(text, isError),
-            ask: (req) => this._renderAsk(req),
-            confirm: (req) => this._renderConfirm(req),
-            results: (tool, res) => {
+            inlinePrompts: !this._classicPrompts,
+            ask: (req) => (this._usesCard(req.tool) ? this._cardAsk(req) : this._renderAsk(req)),
+            confirm: (req) => (this._usesCard(req.tool) ? this._cardConfirm(req) : this._renderConfirm(req)),
+            left: (tool, destination) => this._cardLeft(tool, destination),
+            results: (tool, res, extra) => {
                 const conv = this._active();
-                const item = this._buildResultsItem(tool, res);
+                const item = this._buildResultsItem(tool, res, extra?.pick);
                 // A read that answers in words — "you are on the home page", "already open" — has no records
                 // to draw, and an empty result card reading "No results found." contradicts the answer it
                 // just gave. Say what it said.
@@ -1321,6 +1395,8 @@ class NxisAgentFullscreen extends HTMLElement {
                 this._scroll();
             },
             detail: (tool, values, text) => {
+                if (this._cardDone(tool, values, text))
+                    return;
                 const conv = this._active();
                 const item = this._buildDetailItem(tool, values, text);
                 conv?.items.push(item);
@@ -1345,8 +1421,24 @@ class NxisAgentFullscreen extends HTMLElement {
                 this._saveConversations();
                 this._scroll();
             },
-            toolError: (tool, message) => this._paintToolResult(tool.name, message, true),
-            dismissPrompt: () => this._dismissPrompt(),
+            toolError: (tool, message) => {
+                if (this._cardFailed(tool, message))
+                    return;
+                this._paintToolResult(tool.name, message, true);
+            },
+            dismissPrompt: () => {
+                // A sent card stays, and shows the steps; one never sent says so.
+                const live = this._live;
+                if (live) {
+                    if (live.sent && (live.item.stage === 'review' || live.item.stage === 'collect')) {
+                        live.item.stage = 'working';
+                        this._paintAction(live.item);
+                        this._saveConversations();
+                    }
+                    return;
+                }
+                this._dismissPrompt();
+            },
             // The harness says when stopping stops being possible, because it is the
             // part that knows a tool has been invoked. Once a call is out, offering
             // to stop would be offering to un-send a booking.
@@ -1478,6 +1570,378 @@ class NxisAgentFullscreen extends HTMLElement {
         this._formEl = wrap;
         this._scroll();
     }
+    // ── Action cards ─────────────────────────────────────────────────────────────
+    /** `prompt-style="classic"`: the separate ask, review and submitted cards of earlier versions. */
+    get _classicPrompts() {
+        return this.getAttribute('prompt-style') === 'classic';
+    }
+    /** Whether a prompt for this tool is drawn as an action card: every write and handoff. */
+    _usesCard(tool) {
+        return !this._classicPrompts && (isHandoffTool(tool.name) || !tool.annotations?.readOnlyHint);
+    }
+    /** Details are missing: the card asks for them, beside what it already has. */
+    _cardAsk(req) {
+        const needed = new Set(req.plan.steps.flatMap((st) => st.slots.map((sl) => sl.name)));
+        const item = this._liveCard(req.tool, req.resolution.all, req.resolution.values, needed);
+        this._live.ask = req;
+        this._live.confirm = undefined;
+        item.stage = 'collect';
+        this._paintAction(item);
+        this._saveConversations();
+    }
+    /** Everything is known: the card says what will happen, and waits for Send. */
+    _cardConfirm(req) {
+        const all = resolveSlots(toolSchema(req.tool), { modelArgs: req.values }).all;
+        const item = this._liveCard(req.tool, all, req.values, new Set(), req.destination);
+        this._live.confirm = req;
+        item.stage = 'review';
+        this._paintAction(item);
+        this._saveConversations();
+    }
+    /**
+     * The live card for a tool's prompt: the one already open for this request,
+     * or a new one, which takes over from the journey card of the same request.
+     */
+    _liveCard(tool, slots, values, needed, destination) {
+        const conv = this._active();
+        const id = currentJourney() ?? `a${Date.now().toString(36)}`;
+        const live = this._live;
+        const described = this._describeAction(tool, values, destination);
+        const fields = fieldsFromSlots(this._narrowed(tool, slots, values), values, { needed, hidden: described.hidden, labels: described.labels });
+        if (live && live.item.id === id && live.tool.name === tool.name) {
+            // The same request, a step on: keep what was typed, and anything the harness has since learned.
+            live.item.fields = fields.map((f) => {
+                const had = live.item.fields.find((o) => o.name === f.name);
+                return had && f.value === '' ? { ...f, value: had.value } : f;
+            });
+            Object.assign(live.item, described.view);
+            live.tool = tool;
+            return live.item;
+        }
+        // A request left waiting is replaced by the new one.
+        if (live && (live.item.stage === 'collect' || live.item.stage === 'review')) {
+            live.item.stage = 'declined';
+            this._paintAction(live.item);
+        }
+        const item = { kind: 'action', id, tool: tool.name, fields, stage: 'collect', ...described.view };
+        conv.items.push(item);
+        this._live = { item, tool, sent: false, declining: false };
+        this._els?.thread?.querySelector(`[data-journey="${CSS.escape(id)}"]`)?.remove();
+        this._watchRunningJourney();
+        if (isHandoffTool(tool.name))
+            void this._refreshHandoffTargets(item);
+        return item;
+    }
+    /**
+     * The slots with each field's options cut to the form the call means: one
+     * business's services rather than every business's.
+     */
+    _narrowed(tool, slots, values) {
+        const options = formOptions(tool, values);
+        return slots.map((slot) => {
+            const only = options[slot.name];
+            if (!only)
+                return slot;
+            // Keep a value the call already gave, even one the form does not list: the form decides.
+            const current = values[slot.name];
+            const list = current !== undefined && current !== '' && !only.includes(String(current)) ? [String(current), ...only] : only;
+            return { ...slot, schema: { ...slot.schema, enum: list } };
+        });
+    }
+    /** Who a request goes to, and how the card words it. */
+    _describeAction(tool, values, destination) {
+        const email = String(values.email ?? Object.entries(values).find(([k]) => /e-?mail/i.test(k))?.[1] ?? '').trim();
+        if (isHandoffTool(tool.name)) {
+            const name = String(values.target ?? '');
+            const config = this._handoff?.config?.targets[name];
+            const known = this._handoffTargets.get(name);
+            const label = known?.label ?? config?.label ?? fieldLabel(name || 'the team');
+            const person = (known?.kind ?? config?.kind) !== 'agent';
+            const away = known ? !known.available : false;
+            // "The directory team" leads a line, but mid-sentence it is "the directory team".
+            const inline = label.replace(/^The\s/, 'the ');
+            const about = known?.description ?? config?.description;
+            const status = !known
+                ? undefined
+                : away
+                    ? `Away now${known.hours ? ` · open ${known.hours}` : ''}`
+                    : person
+                        ? known.waitMinutes
+                            ? `Available · replies in ~${known.waitMinutes} min`
+                            : 'Available'
+                        : 'Available';
+            const sentence = !person
+                ? `I'll hand this conversation to ${inline}. They'll take it from here.`
+                : away
+                    ? email
+                        ? `${label} is away right now. They'll reply to ${email}.`
+                        : `${label} is away right now. Leave an email and they'll reply there.`
+                    : `I'll pass this to ${inline} so you don't have to repeat yourself.`;
+            return {
+                view: {
+                    variant: person ? 'handoff-person' : 'handoff-agent',
+                    noun: person ? 'handoff' : 'handover',
+                    identity: { name: label, sub: about ? about.charAt(0).toUpperCase() + about.slice(1) : undefined, status, tone: away ? 'away' : 'ok' },
+                    sentence,
+                    note: undefined,
+                    sendLabel: !person ? 'Hand over' : away ? `Send to ${inline}` : 'Connect me',
+                },
+                hidden: new Set(['target']),
+                labels: { reason: 'Why', summary: 'What they need to know', email: 'Where should they reply?' },
+            };
+        }
+        const noun = fieldLabel(withoutSiteSuffix(tool.name)).toLowerCase();
+        // Which business or place it is for: the site tool's own chooser, else a field the form names it in.
+        const chooser = chooserOf(tool) ?? Object.keys(values).find((k) => /^(business|company|organi[sz]ation|provider|vendor|store|restaurant|practice|venue)(_name)?$/i.test(k)) ?? null;
+        const chosen = chooser ? String(values[chooser] ?? '').trim() : '';
+        const leaving = destination ?? handoffFor(tool, values)?.label;
+        const name = chosen || leaving || this._pageName();
+        // What the conversation already showed about them: their card from a search.
+        const card = this._conversations
+            .find((c) => c.id === this._activeId)
+            ?.items.flatMap((it) => (it.kind === 'results' ? it.cards : []))
+            .find((c) => c.title.toLowerCase() === name.toLowerCase());
+        const sub = [fieldLabel(noun), card?.type && card.type !== 'Thing' ? fieldLabel(card.type) : '', card?.rating ? `★ ${card.rating}` : '']
+            .filter(Boolean)
+            .join(' · ');
+        return {
+            view: {
+                variant: 'form',
+                noun,
+                identity: { name, sub },
+                sentence: `I'll send this ${noun} to ${name}.${email ? ` They'll reply to ${email}.` : ''}`,
+                note: leaving ? 'Their form is on its own page. I’ll open it and send it from there.' : undefined,
+                sendLabel: 'Send',
+            },
+            hidden: new Set(chooser && chooser !== 'target' && chosen ? [chooser] : chooser === 'target' ? ['target'] : []),
+            labels: {},
+        };
+    }
+    /** The site's name for this page: its title, without the site's own name after it. */
+    _pageName() {
+        const title = (typeof document === 'undefined' ? '' : document.title).split(/\s+[|—–·-]\s+/)[0].trim();
+        return title || 'this page';
+    }
+    /** Read availability for a handoff card, and redraw it once known. */
+    async _refreshHandoffTargets(item) {
+        const targets = await this._handoff?.targets().catch(() => []);
+        for (const t of targets ?? [])
+            this._handoffTargets.set(t.name, t);
+        if (item.stage !== 'collect' && item.stage !== 'review')
+            return;
+        const values = Object.fromEntries(item.fields.map((f) => [f.name, f.value]));
+        Object.assign(item, this._describeAction({ name: item.tool }, values).view);
+        this._paintAction(item);
+    }
+    /** What the live card's buttons do. */
+    _actionHandlers() {
+        return {
+            continue: (values) => {
+                const live = this._live;
+                if (!live)
+                    return;
+                if (live.ask && !live.confirm) {
+                    live.ask.onComplete(values);
+                    return;
+                }
+                // Back from a change, or a card of the widget's own: review again, here.
+                Object.assign(live.item, this._describeAction(live.tool, values, live.confirm?.destination).view);
+                live.item.stage = 'review';
+                this._paintAction(live.item);
+                this._saveConversations();
+            },
+            change: () => {
+                const live = this._live;
+                if (!live)
+                    return;
+                live.item.fields.forEach((f) => {
+                    if (f.group === 'needed' && f.value.trim() !== '')
+                        f.group = 'known';
+                });
+                live.sent = false;
+                live.item.stage = 'collect';
+                live.item.open = true;
+                this._paintAction(live.item);
+                this._saveConversations();
+            },
+            send: (values) => {
+                const live = this._live;
+                if (!live)
+                    return;
+                live.sent = true;
+                if (live.confirm)
+                    live.confirm.onSubmit(values);
+                else if (live.run)
+                    void live.run(values);
+            },
+            decline: () => {
+                const live = this._live;
+                if (!live)
+                    return;
+                live.declining = true;
+                if (live.confirm)
+                    live.confirm.onCancel();
+                else if (live.ask)
+                    live.ask.onCancel();
+                // A card the harness is not waiting on declines itself.
+                if (this._live === live) {
+                    live.item.stage = 'declined';
+                    this._paintAction(live.item);
+                    this._live = null;
+                    this._saveConversations();
+                }
+            },
+        };
+    }
+    /** Draw a card where it was, or at the end of the thread. */
+    _paintAction(item) {
+        if (!this._els?.thread)
+            return;
+        const conv = this._active();
+        if (!conv?.items.includes(item))
+            return;
+        const live = this._live?.item === item;
+        const fresh = actionCard(item, live ? this._actionHandlers() : null, () => this._saveConversations());
+        const old = this._els.thread.querySelector(`[data-action="${CSS.escape(item.id)}"]`);
+        if (old)
+            old.replaceWith(fresh);
+        else {
+            this._clearEmpty();
+            this._els.thread.appendChild(fresh);
+            this._scroll();
+        }
+    }
+    /** A request's steps, as its card shows them once sent. */
+    _actionFollows(item, all) {
+        const live = this._live?.item === item ? this._live : null;
+        const failed = [...all].reverse().find((st) => st.status === 'failed');
+        const done = all.some((st) => st.id === 'submit' && st.status === 'done');
+        const running = ['navigate', 'arrive', 'collect', 'fill', 'submit'];
+        item.steps = all
+            .filter((st) => running.includes(st.id))
+            .map((st) => ({
+            label: st.id === 'fill' && st.status === 'active' && item.variant === 'form'
+                ? `Filling in the ${item.noun}`
+                : st.id === 'submit' && st.status === 'done' && item.variant === 'form'
+                    ? 'Sent'
+                    : st.label,
+            status: st.status === 'failed' ? 'failed' : st.status === 'done' ? 'done' : 'active',
+        }));
+        if (failed) {
+            if (live?.declining || failed.label === 'Cancelled') {
+                item.stage = 'declined';
+                if (live)
+                    this._live = null;
+            }
+            else {
+                item.stage = 'failed';
+                item.message = failed.detail || failed.label;
+            }
+        }
+        else if (done) {
+            item.stage = 'done';
+            if (live)
+                this._live = null;
+        }
+        else if (item.stage === 'left' || (item.stage === 'working' && item.steps.length)) {
+            item.stage = 'working';
+        }
+        this._paintAction(item);
+    }
+    /** The confirmed call is leaving for its page. The card says so, and the new page finishes it. */
+    _cardLeft(tool, destination) {
+        const live = this._live;
+        if (!live || live.tool.name !== tool.name) {
+            this._appendMsg('assistant', destination ? `Opening ${destination}…` : 'Opening the page that can submit this…');
+            return;
+        }
+        live.item.stage = 'left';
+        live.item.message = `Opening ${destination ?? live.item.identity.name}’s page to send it from there.`;
+        this._live = null;
+        this._paintAction(live.item);
+        this._saveConversations();
+    }
+    /** The form took it: the card becomes the receipt. False when no card is waiting on this tool. */
+    _cardDone(tool, values, text) {
+        const conv = this._active();
+        const id = currentJourney();
+        const item = conv?.items.find((it) => it.kind === 'action' && it.id === id && it.tool === tool.name);
+        if (!item || this._classicPrompts)
+            return false;
+        const note = this._buildDetailItem(tool, values, text).note;
+        // The default note says nothing the card's "Sent" does not.
+        item.message = /submitted successfully/.test(note) ? undefined : note;
+        item.stage = 'done';
+        item.fields.forEach((f) => {
+            if (values[f.name] !== undefined)
+                f.value = String(values[f.name]);
+        });
+        if (this._live?.item === item)
+            this._live = null;
+        this._paintAction(item);
+        this._saveConversations();
+        return true;
+    }
+    /** It did not go through: the card says why and offers to change it. False when no card is waiting. */
+    _cardFailed(tool, message) {
+        const live = this._live;
+        if (!live || live.tool.name !== tool.name)
+            return false;
+        live.sent = false;
+        live.item.stage = 'failed';
+        live.item.message = message;
+        this._paintAction(live.item);
+        this._saveConversations();
+        return true;
+    }
+    /**
+     * After a page change: the card of the request that travelled, found by its
+     * journey, now finished or asked about here.
+     */
+    _resumedCard(journeyId) {
+        if (!journeyId || this._classicPrompts)
+            return null;
+        return this._active()?.items.find((it) => it.kind === 'action' && it.id === journeyId) ?? null;
+    }
+    /** Let a resumed card be changed and sent again from this page, with the page's own tool. */
+    _reviveCard(item, tool, values, needed) {
+        const slots = resolveSlots(toolSchema(tool), { modelArgs: values }).all;
+        const hidden = new Set(item.fields.filter((f) => f.group === 'hidden').map((f) => f.name));
+        item.fields = fieldsFromSlots(slots, values, { needed: new Set(needed), hidden });
+        this._live = {
+            item,
+            tool,
+            sent: false,
+            declining: false,
+            run: async (vals) => {
+                item.stage = 'working';
+                item.steps = [{ label: `Sending the ${item.noun}`, status: 'active' }];
+                this._paintAction(item);
+                try {
+                    const res = await this.toolSource.execTool(tool, tool.name, vals);
+                    const text = extractResult(res);
+                    if (res?.isError) {
+                        this._cardFailed(tool, text || 'That form did not accept the details.');
+                        return;
+                    }
+                    this._active()?.messages.push({
+                        role: 'user',
+                        content: `[${tool.name} submitted with: ${JSON.stringify(vals)}]. Keep these unless I ask to change them.`,
+                    });
+                    this._live = null;
+                    const note = this._buildDetailItem(tool, vals, text).note;
+                    item.message = /submitted successfully/.test(note) ? undefined : note;
+                    item.stage = 'done';
+                    item.steps = [];
+                    this._paintAction(item);
+                    this._saveConversations();
+                }
+                catch (err) {
+                    this._cardFailed(tool, String(err?.message || err));
+                }
+            },
+        };
+    }
     // ── Inline generated form (from JSON-Schema) ───────────────────────────────
     _renderForm(tool, args) {
         if (this._useA2ui) {
@@ -1792,70 +2256,10 @@ class NxisAgentFullscreen extends HTMLElement {
      * return the first that yields records. Shapes covered: query → results[],
      * list_types → types[], get → result{}, or a bare entity/array. */
     _extractItems(res) {
-        const sources = [];
-        // Collect every candidate payload, recursively unwrapping tool-response
-        // envelopes. `res` can be an object, a JSON string, or (with a WebMCP browser
-        // extension in the loop) the whole `{content, structuredContent}` envelope
-        // serialized to a string, possibly more than once. Diving into both
-        // `structuredContent` and each `content[].text` covers all of them.
-        const visit = (raw, depth = 0) => {
-            if (raw == null || depth > 5)
-                return;
-            const val = raw;
-            if (typeof val === 'string') {
-                const t = val.trim();
-                if (!t)
-                    return;
-                let parsed;
-                try {
-                    parsed = JSON.parse(t);
-                }
-                catch {
-                    return; // plain (non-JSON) text — nothing to extract
-                }
-                // Parsed value may itself be an object/array OR another JSON string
-                // (double-encoded); recurse either way.
-                return visit(parsed, depth + 1);
-            }
-            if (!val || typeof val !== 'object')
-                return;
-            sources.push(val);
-            const v = val;
-            if (v.structuredContent != null)
-                visit(v.structuredContent, depth + 1);
-            if (Array.isArray(v.content)) {
-                for (const c of v.content) {
-                    if (c && typeof c === 'object')
-                        visit(c.text, depth + 1);
-                }
-            }
-        };
-        visit(res);
-        for (const data of sources) {
-            const items = this._itemsFrom(data);
-            if (items.length)
-                return items;
-        }
-        console.warn('[nxis-mcp] no items extracted from tool result', { sourcesTried: sources.length, res });
-        return [];
-    }
-    /** Find the record array within one parsed payload. */
-    _itemsFrom(data) {
-        const objs = (arr) => arr.filter((x) => x && typeof x === 'object');
-        if (Array.isArray(data))
-            return objs(data);
-        if (!data || typeof data !== 'object')
-            return [];
-        const d = data;
-        for (const key of ['results', 'types', 'items', 'entities', 'data']) {
-            if (Array.isArray(d[key]))
-                return objs(d[key]);
-        }
-        if (d.result && typeof d.result === 'object')
-            return [d.result];
-        if (d['@id'] != null || d['@type'] != null || d.name != null)
-            return [d];
-        return [];
+        const items = extractRecords(res);
+        if (!items.length)
+            console.warn('[nxis-mcp] no items extracted from tool result', { res });
+        return items;
     }
     /** Build a display card from a single record (a JSON-LD entity or a type row). */
     _entityCard(entity) {
@@ -1914,15 +2318,77 @@ class NxisAgentFullscreen extends HTMLElement {
         const id = entity['@id'] != null ? str(entity['@id']) : undefined;
         const found = pageForEntity(entity, this._sitePages, location.origin);
         const page = found ? { url: found.url, label: found.name } : undefined;
-        return { title, type, rating, emergency, sub, rows, id, ...(page ? { page } : {}) };
+        // What the answer view compares by, beyond the rating and hours its heading already shows.
+        const facts = recordFacts(entity);
+        const status = openStatus(entity) ?? undefined;
+        const lines = [
+            facts.services.length ? facts.services.slice(0, 3).map((x) => x.name).join(', ') : facts.knows.slice(0, 3).join(', '),
+            facts.since ? `In business since ${facts.since}` : '',
+            facts.reviews[0] ? `\u201c${facts.reviews[0].text}\u201d${facts.reviews[0].author ? ` \u2014 ${facts.reviews[0].author}` : ''}` : '',
+        ].filter((l) => !!l);
+        return {
+            title,
+            type,
+            rating,
+            emergency,
+            sub,
+            rows,
+            id,
+            ...(page ? { page } : {}),
+            ...(facts.rating !== undefined ? { stars: facts.rating } : {}),
+            ...(facts.reviewCount !== undefined ? { reviews: facts.reviewCount } : {}),
+            ...(status ? { status: { open: status.open, label: status.label } } : {}),
+            ...(facts.phone ? { phone: facts.phone } : {}),
+            facts: lines,
+        };
     }
-    _buildResultsItem(tool, res) {
+    _buildResultsItem(tool, res, pick) {
         const items = this._extractItems(res);
         const cards = items.slice(0, 12).map((e) => this._entityCard(e));
         const note = !cards.length
             ? 'No results found.'
             : `${cards.length} result${cards.length === 1 ? '' : 's'}`;
-        return { kind: 'results', title: humanize(tool.name), note, cards };
+        return { kind: 'results', title: humanize(tool.name), note, cards, ...(pick && pick.index < cards.length ? { pick } : {}) };
+    }
+    /**
+     * Results as an answer: the recommended pick with its reasons and the others
+     * to compare, or a short list that opens per result. Records of things
+     * only: a listing of types or counts keeps the plain cards.
+     */
+    _answerEl(item) {
+        // Records of things: a pick, or at least one result with a rating, hours, a phone or a page.
+        // A sparse record beside them (an index entry with only a name) still shows, by name.
+        const things = item.cards.filter((c) => c.stars !== undefined || c.status || c.phone || c.page);
+        if (!item.pick && !things.length)
+            return null;
+        const cards = item.cards.map((c) => {
+            const form = formsFor(c.title)[0];
+            const quote = form && /quote/.test(form.noun);
+            return {
+                title: c.title,
+                stars: c.stars,
+                reviews: c.reviews,
+                status: c.status,
+                phone: c.phone,
+                page: c.page,
+                facts: c.facts ?? [],
+                ...(form
+                    ? {
+                        form: quote
+                            ? { label: 'Get a quote', message: `Get a quote from ${c.title}` }
+                            : { label: `Use their ${form.noun}`, message: `Start the ${form.noun} for ${c.title}` },
+                    }
+                    : {}),
+            };
+        });
+        return resultsAnswer(cards, item.pick, {
+            ask: (text) => {
+                if (this._turnActive)
+                    return;
+                this._els.input.value = text;
+                void this._onSend();
+            },
+        });
     }
     /** Feature-card pattern: tinted icon chip, tags, tight Manrope headline, one
      * supporting line, then mono-labelled detail rows. */
@@ -1982,9 +2448,14 @@ class NxisAgentFullscreen extends HTMLElement {
      * surface; a2ui="a2ui-results" opts this element back into it for comparison.
      */
     _resultsEl(item) {
-        return this.getAttribute('a2ui') === 'a2ui-results'
-            ? this._resultsElA2ui(item)
-            : this._resultsElLegacy(item);
+        if (this.getAttribute('a2ui') === 'a2ui-results')
+            return this._resultsElA2ui(item);
+        if (!this._classicPrompts && item.cards.length) {
+            const answer = this._answerEl(item);
+            if (answer)
+                return answer;
+        }
+        return this._resultsElLegacy(item);
     }
     _resultsElLegacy(item) {
         const wrap = document.createElement('div');
@@ -2367,6 +2838,16 @@ class NxisAgentFullscreen extends HTMLElement {
      * `fallback`. Inexpensive: each agent is a role over the one shared provider,
      * so no additional model is loaded.
      */
+    /** The one agent a page without `agents` runs, on the current provider. */
+    _singleHarness() {
+        return new AgentHarness({
+            provider: this.provider,
+            toolSource: this.toolSource,
+            renderer: this._renderer(),
+            profile: (schema) => this._profileForSchema(schema),
+            onMessages: () => this._saveConversations(),
+        });
+    }
     _buildAgents() {
         if (!this.provider || !this._agentDefs) {
             this._coordinator = null;
@@ -2517,6 +2998,7 @@ class NxisAgentFullscreen extends HTMLElement {
         if (conversationId === this._activeId && this._els?.thread) {
             this._paintHandoffItem(item);
             this._scroll();
+            this._noteThreadGrew();
         }
     }
     _paintHandoffItem(item) {
@@ -2663,6 +3145,42 @@ class NxisAgentFullscreen extends HTMLElement {
         });
         if (outcome.status !== 'none')
             this._setStatus('');
+        // The card that travelled with the request finishes here, when there is one.
+        const card = outcome.status === 'none' ? null : this._resumedCard(outcome.pending.steps?.find((st) => st.journey)?.journey);
+        if (card && outcome.status !== 'none') {
+            switch (outcome.status) {
+                case 'no-registry':
+                case 'no-tool':
+                    card.stage = 'failed';
+                    card.message = `I couldn't find the ${card.noun} on this page, so nothing was sent. Ask me again and I'll fill it in from here.`;
+                    break;
+                case 'incomplete':
+                    this._reviveCard(card, outcome.tool, outcome.pending.values, outcome.missing);
+                    card.stage = 'collect';
+                    card.message = undefined;
+                    break;
+                case 'rejected':
+                case 'failed':
+                    this._reviveCard(card, outcome.tool, outcome.pending.values, []);
+                    card.stage = 'failed';
+                    card.message = outcome.status === 'failed' ? outcome.error : outcome.text || 'That form did not accept the details.';
+                    break;
+                case 'submitted': {
+                    const note = this._buildDetailItem(outcome.tool, outcome.pending.values, outcome.text).note;
+                    card.message = /submitted successfully/.test(note) ? undefined : note;
+                    card.stage = 'done';
+                    this._active()?.messages.push({
+                        role: 'user',
+                        content: `[${outcome.tool.name} submitted with: ${JSON.stringify(outcome.pending.values)}]. ` +
+                            'Keep these unless I ask to change them.',
+                    });
+                    break;
+                }
+            }
+            this._paintAction(card);
+            this._saveConversations();
+            return;
+        }
         switch (outcome.status) {
             case 'none':
                 return;
@@ -2984,6 +3502,9 @@ class NxisAgentFullscreen extends HTMLElement {
         if (this._els?.thread) {
             this.provider = next ?? this.provider;
             this._paintProvenance();
+            // Both the single agent and any configured ones: a page without `agents` kept the old
+            // provider's harness, and answered with the model it had just replaced.
+            this._harness = this._singleHarness();
             this._buildAgents();
         }
     }
@@ -3187,6 +3708,12 @@ class NxisAgentFullscreen extends HTMLElement {
       /* A2UI surfaces inherit the tokens above through --a2ui-* bridges. */
       ${A2UI_THEME_CSS}
 
+      /* The action card: forms and handoffs as one message. */
+      ${ACTION_CARD_CSS}
+
+      /* Search results as an answer: a pick and why, or a short list. */
+      ${RESULTS_ANSWER_CSS}
+
       /* App-icon tile: chevron centered in a 56px tile, Soft Gray, hairline. */
       .launcher {
         position: fixed; right: 20px; bottom: 20px; z-index: 9998;