@nxisai/agent-harness 0.7.0 → 0.9.0

package/src/ui/result-pick.ts

@@ -0,0 +1,233 @@
+/**
+ * Search results as an answer: a recommended pick with its reasons, the
+ * others to compare against, or, when there is nothing to recommend, a short
+ * list that opens up per result.
+ *
+ * The pick comes from the harness (`recommend`): the model chose it and wrote
+ * the lead and reasons, and only reasons the record backs survived. Those are
+ * the only lines marked with a tick. Comparing another result shows that
+ * result's own facts, plainly, without a tick: the agent did not recommend it.
+ *
+ * Plain DOM, every string set as text.
+ *
+ * @module
+ */
+import type { ResultPick } from '../harness/recommend.js';
+
+/** One result, as the answer shows it. */
+export interface AnswerCard {
+  title: string;
+  stars?: number;
+  reviews?: number;
+  status?: { open: boolean; label: string };
+  phone?: string;
+  page?: { url: string; label: string };
+  /** What the record states, short: hours, rating, services, since when. */
+  facts: string[];
+  /** A site form that can be sent to it, and what to ask the agent to start it. */
+  form?: { label: string; message: string };
+}
+
+/** What the answer can ask the conversation to do. */
+export interface AnswerHandlers {
+  /** Send a message as the visitor: "Get a quote from Hatzel & Sons Plumbing". */
+  ask(text: string): void;
+}
+
+type Child = Node | string | null | undefined | false;
+
+function h<K extends keyof HTMLElementTagNameMap>(tag: K, attrs: Record<string, string | undefined> = {}, ...children: Child[]): HTMLElementTagNameMap[K] {
+  const el = document.createElement(tag);
+  for (const [k, v] of Object.entries(attrs)) {
+    if (v === undefined) continue;
+    if (k === 'class') el.className = v;
+    else el.setAttribute(k, v);
+  }
+  for (const c of children) if (c) el.append(c);
+  return el;
+}
+
+const PALETTE = ['#0E4F5C', '#1D4ED8', '#6D28D9', '#9A3412', '#0F766E', '#B45309', '#334155'];
+
+/** Up to two letters, and a colour that stays the same for a name. */
+function avatar(name: string, size: 'lg' | 'sm'): HTMLElement {
+  const words = name.split(/\s+/).filter((w) => /^[\p{L}\p{N}]/u.test(w));
+  const ini = (words.slice(0, 2).map((w) => w[0]).join('') || '?').toUpperCase();
+  let hash = 0;
+  for (const ch of name) hash = (hash * 31 + ch.charCodeAt(0)) >>> 0;
+  const el = h('span', { class: `ra-avatar ${size}`, 'aria-hidden': 'true' }, ini);
+  el.style.background = PALETTE[hash % PALETTE.length];
+  return el;
+}
+
+/** "★ 4.7 (412) · Open now · 24/7". */
+function meta(c: AnswerCard): HTMLElement {
+  const line = h('span', { class: 'ra-meta' });
+  if (c.stars !== undefined) {
+    line.append(h('span', {}, `★ `, h('strong', {}, String(c.stars))));
+    if (c.reviews !== undefined) line.append(h('span', { class: 'ra-faint' }, ` (${c.reviews})`));
+  }
+  if (c.status) {
+    if (line.childNodes.length) line.append(' · ');
+    line.append(h('span', { class: c.status.open ? 'ra-open' : '' }, c.status.label));
+  }
+  return line;
+}
+
+function actions(c: AnswerCard, handlers: AnswerHandlers, primary: boolean): HTMLElement {
+  const row = h('div', { class: 'ra-actions' });
+  const tel = c.phone ? c.phone.replace(/[^\d+]/g, '') : '';
+  if (tel) row.append(h('a', { class: `ra-btn ${primary ? 'primary' : ''}`, href: `tel:${tel}` }, `Call ${c.phone}`));
+  if (c.form) {
+    const b = h('button', { type: 'button', class: `ra-btn ${primary && !tel ? 'primary' : ''}` }, c.form.label);
+    b.addEventListener('click', () => handlers.ask(c.form!.message));
+    row.append(b);
+  }
+  if (c.page) row.append(h('a', { class: 'ra-btn', href: c.page.url }, 'Their page'));
+  return row;
+}
+
+/**
+ * Draw the answer.
+ *
+ * @param cards - The results, in order.
+ * @param pick - The recommendation, when the harness made one.
+ */
+export function resultsAnswer(cards: AnswerCard[], pick: ResultPick | undefined, handlers: AnswerHandlers): HTMLElement {
+  const wrap = h('div', { class: 'msg assistant results-answer' });
+  const valid = pick && cards[pick.index] ? pick : undefined;
+  if (!valid) {
+    wrap.append(list(cards, handlers, 0));
+    return wrap;
+  }
+
+  let showing = valid.index;
+  const body = h('div', { class: 'ra-body' });
+  const draw = () => {
+    const c = cards[showing];
+    const mine = showing === valid.index;
+    const box = h('div', { class: `ra-pick ${mine ? 'is-pick' : ''}` });
+    const head = h('div', { class: 'ra-head' }, avatar(c.title, 'lg'), h('div', { class: 'ra-who' }, h('strong', {}, c.title), meta(c)));
+    box.append(head);
+    // Ticks only for what the agent recommended, and could back from the record.
+    const lines = mine ? valid.reasons : c.facts;
+    if (lines.length) {
+      const ul = h('ul', { class: `ra-reasons ${mine ? 'ticked' : ''}` });
+      lines.forEach((l) => ul.append(h('li', {}, h('span', { class: 'ra-mark', 'aria-hidden': 'true' }, mine ? '✓' : '•'), h('span', {}, l))));
+      box.append(ul);
+    }
+    box.append(actions(c, handlers, true));
+
+    const lead = mine ? h('p', { class: 'ra-lead' }, valid.lead) : h('p', { class: 'ra-lead' }, `Comparing ${c.title} with my pick, ${cards[valid.index].title}. `);
+    if (!mine) {
+      const back = h('button', { type: 'button', class: 'ra-link' }, 'Back to my pick');
+      back.addEventListener('click', () => {
+        showing = valid.index;
+        draw();
+      });
+      lead.append(back);
+    }
+
+    const others = cards.map((o, i) => ({ o, i })).filter(({ i }) => i !== showing).slice(0, 3);
+    const also = h('div', { class: 'ra-also' }, h('div', { class: 'ra-eyebrow' }, mine ? 'Also good · tap to compare' : 'Others'));
+    for (const { o, i } of others) {
+      const row = h('button', { type: 'button', class: 'ra-row' }, avatar(o.title, 'sm'), h('span', { class: 'ra-who' }, h('strong', {}, o.title), meta(o)), h('span', { class: 'ra-chev', 'aria-hidden': 'true' }, '›'));
+      row.addEventListener('click', () => {
+        showing = i;
+        draw();
+      });
+      also.append(row);
+    }
+    body.replaceChildren(lead, box, ...(others.length ? [also] : []));
+    if (cards.length > 4) {
+      const all = h('button', { type: 'button', class: 'ra-link' }, `Show all ${cards.length}`);
+      all.addEventListener('click', () => body.replaceChildren(list(cards, handlers, valid.index)));
+      body.append(all);
+    }
+  };
+  draw();
+  wrap.append(body);
+  return wrap;
+}
+
+/** The plain list: one line per result, each opening to its facts and actions. */
+function list(cards: AnswerCard[], handlers: AnswerHandlers, open: number | null): HTMLElement {
+  const box = h('div', { class: 'ra-list' });
+  const SHOWN = 5;
+  let all = cards.length <= SHOWN + 1;
+  let openIndex = open;
+  const draw = () => {
+    box.replaceChildren();
+    cards.slice(0, all ? cards.length : SHOWN).forEach((c, i) => {
+      const expanded = openIndex === i;
+      const item = h('div', { class: 'ra-item' });
+      const id = `ra-${i}-${Math.random().toString(36).slice(2, 7)}`;
+      const row = h('button', { type: 'button', class: 'ra-row plain', 'aria-expanded': String(expanded), 'aria-controls': id }, avatar(c.title, 'sm'), h('span', { class: 'ra-who' }, h('strong', {}, c.title), meta(c)), h('span', { class: 'ra-chev', 'aria-hidden': 'true' }, expanded ? '−' : '+'));
+      row.addEventListener('click', () => {
+        openIndex = expanded ? null : i;
+        draw();
+      });
+      item.append(row);
+      if (expanded) {
+        const more = h('div', { class: 'ra-more', id });
+        if (c.facts.length) {
+          const ul = h('ul', { class: 'ra-reasons' });
+          c.facts.forEach((f) => ul.append(h('li', {}, h('span', { class: 'ra-mark', 'aria-hidden': 'true' }, '•'), h('span', {}, f))));
+          more.append(ul);
+        }
+        more.append(actions(c, handlers, false));
+        item.append(more);
+      }
+      box.append(item);
+    });
+    if (!all) {
+      const more = h('button', { type: 'button', class: 'ra-showmore' }, `Show ${cards.length - SHOWN} more`);
+      more.addEventListener('click', () => {
+        all = true;
+        draw();
+      });
+      box.append(more);
+    }
+  };
+  draw();
+  return box;
+}
+
+/** Styles, on the widget's tokens. */
+export const RESULTS_ANSWER_CSS = `
+      .results-answer { align-self: flex-start; width: min(100%, 440px); box-sizing: border-box; padding: 12px 14px; background: var(--surface); border: 1px solid var(--border); border-radius: 16px 16px 16px 4px; font-size: 14px; line-height: 1.5; color: var(--ink); white-space: normal; }
+      .ra-body { display: flex; flex-direction: column; gap: 12px; }
+      .ra-lead { margin: 0; }
+      .ra-pick { background: var(--bg); border: 1px solid var(--border-strong); border-radius: 14px; padding: 12px; display: flex; flex-direction: column; gap: 10px; }
+      .ra-pick.is-pick { border: 1.5px solid var(--blue); box-shadow: 0 0 0 4px var(--blue-tint); }
+      .ra-head { display: flex; align-items: center; gap: 10px; }
+      .ra-avatar { flex-shrink: 0; display: grid; place-items: center; color: #fff; font-weight: 700; letter-spacing: .02em; }
+      .ra-avatar.lg { width: 40px; height: 40px; border-radius: 12px; font-size: 13px; }
+      .ra-avatar.sm { width: 30px; height: 30px; border-radius: 9px; font-size: 11px; }
+      .ra-who { display: flex; flex-direction: column; gap: 1px; min-width: 0; flex-grow: 1; text-align: left; }
+      .ra-who strong { font-size: 14.5px; font-weight: 650; }
+      .ra-meta { font-size: 12.5px; color: var(--ink-2); }
+      .ra-meta strong { color: var(--ink); font-size: 12.5px; font-weight: 600; }
+      .ra-faint { color: var(--ink-3); }
+      .ra-open { color: var(--green-strong); font-weight: 600; }
+      .ra-reasons { list-style: none; margin: 0; padding: 0; display: flex; flex-direction: column; gap: 6px; font-size: 13px; color: var(--ink-2); }
+      .ra-reasons li { display: flex; gap: 8px; align-items: flex-start; }
+      .ra-mark { width: 18px; height: 18px; flex-shrink: 0; border-radius: 50%; display: grid; place-items: center; font-size: 11px; font-weight: 700; color: var(--ink-3); }
+      .ra-reasons.ticked .ra-mark { background: var(--green-tint); color: var(--green-strong); }
+      .ra-actions { display: flex; flex-wrap: wrap; gap: 8px; }
+      .ra-btn { min-height: 40px; padding: 0 14px; border-radius: var(--radius-sm); border: 1px solid var(--border-strong); background: var(--bg); color: var(--ink); font: 600 13.5px var(--sans); display: inline-flex; align-items: center; justify-content: center; text-decoration: none; cursor: pointer; }
+      .ra-btn.primary { flex-grow: 1; border: 0; background: var(--blue); color: #fff; }
+      .ra-btn.primary:hover { background: var(--blue-strong); }
+      .ra-also { display: flex; flex-direction: column; gap: 6px; }
+      .ra-eyebrow { font-family: var(--mono); font-size: 10.5px; font-weight: 500; letter-spacing: .1em; text-transform: uppercase; color: var(--ink-3); }
+      .ra-row { display: flex; align-items: center; gap: 10px; width: 100%; padding: 8px 10px; border: 1px solid var(--border); border-radius: 10px; background: var(--bg); color: var(--ink); font: inherit; cursor: pointer; }
+      .ra-row:hover { border-color: var(--border-strong); }
+      .ra-row.plain { border: 0; border-radius: 0; padding: 10px 12px; }
+      .ra-chev { color: var(--ink-3); font-size: 17px; line-height: 1; }
+      .ra-link { align-self: flex-start; border: 0; background: none; padding: 0; font: 600 13px var(--sans); color: var(--blue-strong); cursor: pointer; }
+      .ra-list { background: var(--bg); border: 1px solid var(--border); border-radius: 12px; overflow: hidden; }
+      .ra-item + .ra-item { border-top: 1px solid var(--border); }
+      .ra-more { padding: 0 12px 12px 52px; display: flex; flex-direction: column; gap: 8px; }
+      .ra-showmore { width: 100%; min-height: 40px; border: 0; border-top: 1px solid var(--border); background: var(--bg); color: var(--blue-strong); font: 600 13px var(--sans); cursor: pointer; }
+      .ra-btn:focus-visible, .ra-row:focus-visible, .ra-link:focus-visible, .ra-showmore:focus-visible { outline: 2px solid var(--blue); outline-offset: 2px; }
+`;