@nxisai/agent-harness 0.8.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,13 +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, formsFor, 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';
@@ -415,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.
@@ -1304,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;
@@ -1340,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();
@@ -2326,6 +2340,7 @@ class NxisAgentFullscreen extends HTMLElement {
             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,
@@ -2339,6 +2354,7 @@ class NxisAgentFullscreen extends HTMLElement {
             ...(facts.reviewCount !== undefined ? { reviews: facts.reviewCount } : {}),
             ...(status ? { status: { open: status.open, label: status.label } } : {}),
             ...(facts.phone ? { phone: facts.phone } : {}),
+            ...(action ? { action } : {}),
             facts: lines,
         };
     }
@@ -2362,7 +2378,9 @@ class NxisAgentFullscreen extends HTMLElement {
         if (!item.pick && !things.length)
             return null;
         const cards = item.cards.map((c) => {
-            const form = formsFor(c.title)[0];
+            // 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,
@@ -2372,13 +2390,15 @@ class NxisAgentFullscreen extends HTMLElement {
                 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}` },
-                    }
-                    : {}),
+                ...(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, {
@@ -2410,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. */
@@ -2422,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);
@@ -3127,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) => {