@nxisai/agent-harness 0.7.0 → 0.9.0

package/dist/ui/agent-fullscreen.js

@@ -22,6 +22,7 @@
  */
 import { mountSurface } from '../a2ui/host.js';
 import { emitCardsSurface } from '../a2ui/cards.js';
+import { actionCta } from '../harness/cta.js';
 import { emitToolForm } from '../a2ui/form.js';
 import { A2UI_THEME_CSS } from '../a2ui/theme.js';
 // Compiled from agent.tw.css at build time (scripts/css-to-ts.mjs). It is a
@@ -34,11 +35,14 @@ 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 { chooserOf, formOptions, handoffFor, isSiteTool, withoutSiteSuffix, HANDOFF_RESULT, } from '../harness/tools/action-tools.js';
+import { chooserOf, formOptions, formsFor, handoffFor, isSiteTool, siteFormFor, 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 { findHandoffForm, startFormMessage, startMessage, takeInboundHandoff } from '../harness/tools/inbound.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';
@@ -413,6 +417,8 @@ class NxisAgentFullscreen extends HTMLElement {
         // belongs to is the one open.
         void this._resumePendingAction();
         this._resumePendingVisit();
+        // Sent here from the NxisAI app to use one of this page's forms.
+        void this._arriveFromHandoff();
         this._els.launcher.addEventListener('click', () => this._open());
         this._els.handoffBack.addEventListener('click', () => void this._endHandoff());
         // A handoff left open on the last page carries on here.
@@ -1302,7 +1308,14 @@ class NxisAgentFullscreen extends HTMLElement {
         return bubble;
     }
     // ── Turn loop ──────────────────────────────────────────────────────────────
-    async _onSend() {
+    /**
+     * Send what is in the composer.
+     *
+     * @param call - A tool call already decided, run without asking the model
+     *   (a handoff names its form). Falls back to an ordinary turn when no agent
+     *   here holds the tool.
+     */
+    async _onSend(call) {
         const goal = this._els.input.value.trim();
         if (!goal || this._turnActive)
             return;
@@ -1338,7 +1351,10 @@ class NxisAgentFullscreen extends HTMLElement {
             await this._connectTools();
             this._syncProfileContext();
             // One agent, or several with a router in front: the signatures match.
-            await (this._coordinator ?? this._harness).turn(goal, conv.messages);
+            const engine = this._coordinator ?? this._harness;
+            const begun = call ? await engine.begin(goal, call.name, call.args, conv.messages) : null;
+            if (!begun || begun.decision === 'unavailable')
+                await engine.turn(goal, conv.messages);
             // A remote endpoint reports which model answered; the name beside the
             // input follows it rather than keeping whatever was configured.
             this._paintProvenance();
@@ -1372,9 +1388,9 @@ class NxisAgentFullscreen extends HTMLElement {
             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) => {
+            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.
@@ -2254,70 +2270,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) {
@@ -2376,15 +2332,83 @@ 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);
+        const action = actionCta(entity, title);
+        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 } : {}),
+            ...(action ? { action } : {}),
+            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) => {
+            // The record's own action first: the same map and prompt as the Typed Retrieval skill and the NxisAI
+            // app. A record that states none falls back to a form found on this page for it.
+            const form = c.action ? undefined : 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 ?? [],
+                ...(c.action
+                    ? { form: { label: c.action.label, message: c.action.message } }
+                    : 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. */
@@ -2406,6 +2430,7 @@ class NxisAgentFullscreen extends HTMLElement {
                 ...(c.emergency ? [{ label: '24/7' }] : []),
             ],
             rows: c.rows.map((r) => ({ label: r.label, value: r.value })),
+            actions: c.action ? [c.action] : [],
         }));
     }
     /** Results rendered through A2UI instead of the bespoke card markup. */
@@ -2418,7 +2443,15 @@ class NxisAgentFullscreen extends HTMLElement {
         }
         try {
             const messages = emitCardsSurface(item.note, this._toA2uiCards(item.cards));
-            const mounted = mountSurface(wrap, messages);
+            const mounted = mountSurface(wrap, messages, (event) => {
+                const name = event?.event?.name ?? event?.name ?? '';
+                const ctx = (event?.event?.context ?? event?.context ?? {});
+                // A card's action button: send its message as the visitor, as the inline card does.
+                if (name === 'nxis.ask' && typeof ctx.message === 'string' && !this._turnActive) {
+                    this._els.input.value = ctx.message;
+                    void this._onSend();
+                }
+            });
             if (!mounted)
                 throw new Error('no surface produced');
             this._surfaces.push(mounted);
@@ -2444,9 +2477,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');
@@ -3118,6 +3156,43 @@ class NxisAgentFullscreen extends HTMLElement {
         if (this.mode !== 'fullscreen')
             this._open();
     }
+    /**
+     * Open on the form a link from the NxisAI app names.
+     *
+     * In a new conversation: the person arrives from another app, and nothing
+     * on this site led here. The agent starts the form in its own words, so the
+     * link only chooses which form; what the person wanted waits in the
+     * composer for them to send, change or delete.
+     */
+    async _arriveFromHandoff() {
+        const handoff = takeInboundHandoff();
+        if (!handoff)
+            return;
+        this._newConversation();
+        this._open();
+        this._setStatus('Opening the form…');
+        // The site's own tools first: they reach a form from any page, from the
+        // site's records, so they work where the page registers nothing itself.
+        await this._connectTools();
+        const site = siteFormFor(handoff.actionId);
+        const start = site
+            ? startFormMessage(site.noun, site.choice)
+            : await findHandoffForm(handoff).then((o) => (o.status === 'ready' ? startMessage(o.tool) : null));
+        this._setStatus('');
+        if (!start) {
+            this._appendMsg('assistant', "I couldn't find that form on this page. Tell me what you need and I'll help from here.");
+        }
+        else if (!this._turnActive) {
+            this._els.input.value = start;
+            // The form is known, so it opens without the model choosing it: left to
+            // choose, a model sometimes asks for the details in prose instead.
+            await this._onSend(site ? { name: site.tool, args: site.args } : undefined);
+        }
+        if (handoff.intent && !this._els.input.value) {
+            this._els.input.value = handoff.intent;
+            this._autosize();
+        }
+    }
     async _resumePendingAction() {
         const outcome = await resumePendingAction({
             onStart: (pending) => {
@@ -3702,6 +3777,9 @@ class NxisAgentFullscreen extends HTMLElement {
       /* 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;