@adia-ai/a2ui-retrieval 0.6.2 → 0.6.6

package/intent/intent-alignment.js

@@ -1,243 +1,172 @@
-/**
- * Intent Alignment Verification — checks whether generated output
- * actually contains what the user asked for.
- *
- * Extracts expectations from the intent (field labels, component types,
- * quantities, action verbs) and verifies them against the A2UI output.
- *
- * Returns a structured alignment report with per-expectation pass/fail,
- * an overall alignment score (0-1), and specific gaps.
- */
-
-// ── Expectation Extractors ──────────────────────────────────────────────
-
-/** Field/label expectations — "email", "password", "name", etc. */
 const FIELD_PATTERNS = [
-  /\b(email|password|username|name|phone|address|city|state|zip|country|company|title|role|bio|url|website|date|time|description|message|subject|amount|price|quantity|search|notes?)\b/gi,
+  /\b(email|password|username|name|phone|address|city|state|zip|country|company|title|role|bio|url|website|date|time|description|message|subject|amount|price|quantity|search|notes?)\b/gi
 ];
-
-/** Component type expectations — "button", "form", "table", etc. */
 const COMPONENT_PATTERNS = [
-  /\b(button|form|table|chart|card|avatar|badge|alert|modal|drawer|tabs?|sidebar|navbar|breadcrumb|pagination|progress|slider|toggle|checkbox|radio|dropdown|select|upload|calendar|timeline|steps?|accordion)\b/gi,
+  /\b(button|form|table|chart|card|avatar|badge|alert|modal|drawer|tabs?|sidebar|navbar|breadcrumb|pagination|progress|slider|toggle|checkbox|radio|dropdown|select|upload|calendar|timeline|steps?|accordion)\b/gi
 ];
-
-/** Quantity expectations — "3 cards", "two columns", etc. */
 const QUANTITY_MAP = { one: 1, two: 2, three: 3, four: 4, five: 5, six: 6, seven: 7, eight: 8, nine: 9, ten: 10 };
 const QUANTITY_PATTERN = /\b(\d+|one|two|three|four|five|six|seven|eight|nine|ten)\s+(cards?|columns?|items?|fields?|buttons?|sections?|rows?|tiles?|steps?|tabs?|metrics?|stats?)\b/gi;
-
-/** Action expectations — "submit", "cancel", "delete", etc. */
 const ACTION_PATTERNS = [
-  /\b(submit|cancel|save|delete|edit|close|open|search|filter|sort|login|signup|register|checkout|confirm|reset|send|upload|download|share|copy|print)\b/gi,
+  /\b(submit|cancel|save|delete|edit|close|open|search|filter|sort|login|signup|register|checkout|confirm|reset|send|upload|download|share|copy|print)\b/gi
 ];
-
-/** Specific content expectations — quoted strings, dollar amounts, percentages */
 const CONTENT_PATTERNS = [
-  /["']([^"']+)["']/g,           // quoted strings
-  /\$[\d,.]+/g,                   // dollar amounts
-  /\d+%/g,                        // percentages
+  /["']([^"']+)["']/g,
+  // quoted strings
+  /\$[\d,.]+/g,
+  // dollar amounts
+  /\d+%/g
+  // percentages
 ];
-
-/**
- * Extract expectations from a natural language intent.
- *
- * @param {string} intent
- * @returns {{ fields: string[], componentTypes: string[], quantities: { count: number, type: string }[], actions: string[], content: string[] }}
- */
-export function extractExpectations(intent) {
+function extractExpectations(intent) {
   const lower = intent.toLowerCase();
-
-  // Fields
   const fields = [];
   for (const pattern of FIELD_PATTERNS) {
     pattern.lastIndex = 0;
     let match;
-    while ((match = pattern.exec(lower))) {
-      const f = match[1].toLowerCase();
+    while (match = pattern.exec(lower)) {
+      const f = (match[1] ?? "").toLowerCase();
       if (!fields.includes(f)) fields.push(f);
     }
   }
-
-  // Component types
   const componentTypes = [];
   for (const pattern of COMPONENT_PATTERNS) {
     pattern.lastIndex = 0;
     let match;
-    while ((match = pattern.exec(lower))) {
-      const t = match[1].toLowerCase();
+    while (match = pattern.exec(lower)) {
+      const t = (match[1] ?? "").toLowerCase();
       if (!componentTypes.includes(t)) componentTypes.push(t);
     }
   }
-
-  // Quantities
   const quantities = [];
   QUANTITY_PATTERN.lastIndex = 0;
   let qMatch;
-  while ((qMatch = QUANTITY_PATTERN.exec(lower))) {
-    const num = QUANTITY_MAP[qMatch[1]] || parseInt(qMatch[1], 10);
-    const type = qMatch[2].replace(/s$/, ''); // singularize
+  while (qMatch = QUANTITY_PATTERN.exec(lower)) {
+    const raw = qMatch[1] ?? "";
+    const num = QUANTITY_MAP[raw] ?? parseInt(raw, 10);
+    const type = (qMatch[2] ?? "").replace(/s$/, "");
     if (!isNaN(num)) quantities.push({ count: num, type });
   }
-
-  // Actions
   const actions = [];
   for (const pattern of ACTION_PATTERNS) {
     pattern.lastIndex = 0;
     let match;
-    while ((match = pattern.exec(lower))) {
-      const a = match[1].toLowerCase();
+    while (match = pattern.exec(lower)) {
+      const a = (match[1] ?? "").toLowerCase();
       if (!actions.includes(a)) actions.push(a);
     }
   }
-
-  // Specific content
   const content = [];
   for (const pattern of CONTENT_PATTERNS) {
     pattern.lastIndex = 0;
     let match;
-    while ((match = pattern.exec(intent))) {
-      content.push(match[1] || match[0]);
+    while (match = pattern.exec(intent)) {
+      content.push(match[1] ?? match[0]);
     }
   }
-
   return { fields, componentTypes, quantities, actions, content };
 }
-
-// ── A2UI Type Mapping ───────────────────────────────────────────────────
-
-/** Map intent keywords to A2UI component types */
 const TYPE_MAP = {
-  button: ['Button'],
-  form: ['FormContainer', 'TextField', 'Column'],
-  table: ['Table'],
-  chart: ['Chart'],
-  card: ['Card'],
-  avatar: ['Avatar'],
-  badge: ['Badge'],
-  alert: ['Alert'],
-  modal: ['Modal', 'Dialog'],
-  drawer: ['Drawer'],
-  tab: ['Tabs', 'Tab'],
-  sidebar: ['Sidebar'],
-  navbar: ['Nav'],
-  breadcrumb: ['Breadcrumb'],
-  pagination: ['Pagination'],
-  progress: ['Progress'],
-  slider: ['Slider'],
-  toggle: ['Toggle'],
-  checkbox: ['CheckBox'],
-  radio: ['Radio'],
-  dropdown: ['ChoicePicker', 'Select'],
-  select: ['ChoicePicker', 'Select'],
-  upload: ['Upload'],
-  calendar: ['CalendarPicker', 'DateTimeInput'],
-  timeline: ['Timeline'],
-  step: ['Steps'],
-  accordion: ['Accordion'],
+  button: ["Button"],
+  form: ["FormContainer", "TextField", "Column"],
+  table: ["Table"],
+  chart: ["Chart"],
+  card: ["Card"],
+  avatar: ["Avatar"],
+  badge: ["Badge"],
+  alert: ["Alert"],
+  modal: ["Modal", "Dialog"],
+  drawer: ["Drawer"],
+  tab: ["Tabs", "Tab"],
+  sidebar: ["Sidebar"],
+  navbar: ["Nav"],
+  breadcrumb: ["Breadcrumb"],
+  pagination: ["Pagination"],
+  progress: ["Progress"],
+  slider: ["Slider"],
+  toggle: ["Toggle"],
+  checkbox: ["CheckBox"],
+  radio: ["Radio"],
+  dropdown: ["ChoicePicker", "Select"],
+  select: ["ChoicePicker", "Select"],
+  upload: ["Upload"],
+  calendar: ["CalendarPicker", "DateTimeInput"],
+  timeline: ["Timeline"],
+  step: ["Steps"],
+  accordion: ["Accordion"]
 };
-
-/**
- * Verify generated A2UI output against extracted expectations.
- *
- * @param {object[]} components — Flat adjacency array from messages[0].components
- * @param {{ fields: string[], componentTypes: string[], quantities: { count: number, type: string }[], actions: string[], content: string[] }} expectations
- * @returns {{ score: number, checks: { category: string, expected: string, found: boolean, detail: string }[], gaps: string[] }}
- */
-export function verifyAlignment(components, expectations) {
+function verifyAlignment(components, expectations) {
   const checks = [];
   const gaps = [];
-
-  // Collect all text content and properties from components
-  const allText = components.map(c => {
-    const texts = [c.textContent, c.text, c.label, c.placeholder, c.description, c.name];
-    return texts.filter(Boolean).join(' ').toLowerCase();
-  }).join(' ');
-
-  const allTypes = new Set(components.map(c => c.component));
-
-  // ── Check fields ──
+  const allText = components.map((c) => {
+    const texts = [c["textContent"], c["text"], c["label"], c["placeholder"], c["description"], c["name"]];
+    return texts.filter(Boolean).join(" ").toLowerCase();
+  }).join(" ");
+  const allTypes = new Set(components.map((c) => c.component));
   for (const field of expectations.fields) {
-    const found = allText.includes(field) ||
-      components.some(c => (c.label || '').toLowerCase().includes(field) ||
-        (c.placeholder || '').toLowerCase().includes(field) ||
-        (c.name || '').toLowerCase().includes(field));
+    const found = allText.includes(field) || components.some((c) => (c["label"] ?? "").toLowerCase().includes(field) || (c["placeholder"] ?? "").toLowerCase().includes(field) || (c["name"] ?? "").toLowerCase().includes(field));
     checks.push({
-      category: 'field',
+      category: "field",
       expected: field,
       found,
-      detail: found ? `Found "${field}" in component properties` : `Missing field: "${field}"`,
+      detail: found ? `Found "${field}" in component properties` : `Missing field: "${field}"`
     });
     if (!found) gaps.push(`Missing field "${field}"`);
   }
-
-  // ── Check component types ──
   for (const type of expectations.componentTypes) {
-    const mappedTypes = TYPE_MAP[type] || [type.charAt(0).toUpperCase() + type.slice(1)];
-    const found = mappedTypes.some(t => allTypes.has(t));
+    const mappedTypes = TYPE_MAP[type] ?? [type.charAt(0).toUpperCase() + type.slice(1)];
+    const found = mappedTypes.some((t) => allTypes.has(t));
     checks.push({
-      category: 'componentType',
+      category: "componentType",
       expected: type,
       found,
-      detail: found ? `Found ${type} component` : `Missing component type: ${type}`,
+      detail: found ? `Found ${type} component` : `Missing component type: ${type}`
     });
     if (!found) gaps.push(`Missing ${type} component`);
   }
-
-  // ── Check quantities ──
   for (const { count, type } of expectations.quantities) {
-    const mappedTypes = TYPE_MAP[type] || [type.charAt(0).toUpperCase() + type.slice(1)];
-    const actual = components.filter(c => mappedTypes.some(t => c.component === t)).length;
+    const mappedTypes = TYPE_MAP[type] ?? [type.charAt(0).toUpperCase() + type.slice(1)];
+    const actual = components.filter((c) => mappedTypes.some((t) => c.component === t)).length;
     const found = actual >= count;
     checks.push({
-      category: 'quantity',
+      category: "quantity",
       expected: `${count} ${type}(s)`,
       found,
-      detail: found ? `Found ${actual} ${type}(s) (expected ${count})` : `Only ${actual} ${type}(s), expected ${count}`,
+      detail: found ? `Found ${actual} ${type}(s) (expected ${count})` : `Only ${actual} ${type}(s), expected ${count}`
     });
     if (!found) gaps.push(`Expected ${count} ${type}(s), found ${actual}`);
   }
-
-  // ── Check actions ──
   for (const action of expectations.actions) {
-    const found = allText.includes(action) ||
-      components.some(c => c.component === 'Button' && (c.text || '').toLowerCase().includes(action));
+    const found = allText.includes(action) || components.some((c) => c.component === "Button" && (c["text"] ?? "").toLowerCase().includes(action));
     checks.push({
-      category: 'action',
+      category: "action",
       expected: action,
       found,
-      detail: found ? `Found "${action}" action` : `Missing action: "${action}"`,
+      detail: found ? `Found "${action}" action` : `Missing action: "${action}"`
     });
     if (!found) gaps.push(`Missing "${action}" action`);
   }
-
-  // ── Check specific content ──
   for (const text of expectations.content) {
     const found = allText.includes(text.toLowerCase());
     checks.push({
-      category: 'content',
+      category: "content",
       expected: text,
       found,
-      detail: found ? `Found content "${text}"` : `Missing content: "${text}"`,
+      detail: found ? `Found content "${text}"` : `Missing content: "${text}"`
     });
     if (!found) gaps.push(`Missing content "${text}"`);
   }
-
-  // ── Score ──
   const total = checks.length;
-  const passed = checks.filter(c => c.found).length;
-  const score = total > 0 ? Math.round((passed / total) * 100) / 100 : 1;
-
+  const passed = checks.filter((c) => c.found).length;
+  const score = total > 0 ? Math.round(passed / total * 100) / 100 : 1;
   return { score, checks, gaps };
 }
-
-/**
- * Full intent alignment check — extract + verify in one call.
- *
- * @param {string} intent
- * @param {object[]} components
- * @returns {{ score: number, checks: object[], gaps: string[], expectations: object }}
- */
-export function checkIntentAlignment(intent, components) {
+function checkIntentAlignment(intent, components) {
   const expectations = extractExpectations(intent);
   const result = verifyAlignment(components, expectations);
   return { ...result, expectations };
 }
+export {
+  checkIntentAlignment,
+  extractExpectations,
+  verifyAlignment
+};

package/intent/intent-alignment.ts

@@ -72,7 +72,7 @@ export function extractExpectations(intent: string): Expectations {
     pattern.lastIndex = 0;
     let match;
     while ((match = pattern.exec(lower))) {
-      const f = match[1].toLowerCase();
+      const f = (match[1] ?? '').toLowerCase();
       if (!fields.includes(f)) fields.push(f);
     }
   }
@@ -83,7 +83,7 @@ export function extractExpectations(intent: string): Expectations {
     pattern.lastIndex = 0;
     let match;
     while ((match = pattern.exec(lower))) {
-      const t = match[1].toLowerCase();
+      const t = (match[1] ?? '').toLowerCase();
       if (!componentTypes.includes(t)) componentTypes.push(t);
     }
   }
@@ -93,9 +93,9 @@ export function extractExpectations(intent: string): Expectations {
   QUANTITY_PATTERN.lastIndex = 0;
   let qMatch;
   while ((qMatch = QUANTITY_PATTERN.exec(lower))) {
-    const raw = qMatch[1];
+    const raw = qMatch[1] ?? '';
     const num = QUANTITY_MAP[raw] ?? parseInt(raw, 10);
-    const type = qMatch[2].replace(/s$/, ''); // singularize
+    const type = (qMatch[2] ?? '').replace(/s$/, ''); // singularize
     if (!isNaN(num)) quantities.push({ count: num, type });
   }
 
@@ -105,7 +105,7 @@ export function extractExpectations(intent: string): Expectations {
     pattern.lastIndex = 0;
     let match;
     while ((match = pattern.exec(lower))) {
-      const a = match[1].toLowerCase();
+      const a = (match[1] ?? '').toLowerCase();
       if (!actions.includes(a)) actions.push(a);
     }
   }

package/intent/intent-categorizer.js

@@ -1,97 +1,69 @@
-/**
- * Intent Categorizer
- *
- * Maps free-text intents to a taxonomy of UI categories using keyword matching.
- * Used by the feedback analyzer to aggregate metrics per intent type.
- */
-
 const CATEGORY_RULES = [
   // Form categories
-  { category: 'form/login',    keywords: ['login', 'sign in', 'signin', 'log in', 'authentication'] },
-  { category: 'form/signup',   keywords: ['signup', 'sign up', 'register', 'registration', 'create account', 'onboarding'] },
-  { category: 'form/contact',  keywords: ['contact', 'contact us', 'reach out', 'get in touch', 'enquiry', 'inquiry'] },
-  { category: 'form/settings', keywords: ['settings', 'preferences', 'config', 'configuration', 'account settings', 'profile edit'] },
-  { category: 'form/checkout', keywords: ['checkout', 'check out', 'payment', 'billing', 'purchase'] },
-
+  { category: "form/login", keywords: ["login", "sign in", "signin", "log in", "authentication"] },
+  { category: "form/signup", keywords: ["signup", "sign up", "register", "registration", "create account", "onboarding"] },
+  { category: "form/contact", keywords: ["contact", "contact us", "reach out", "get in touch", "enquiry", "inquiry"] },
+  { category: "form/settings", keywords: ["settings", "preferences", "config", "configuration", "account settings", "profile edit"] },
+  { category: "form/checkout", keywords: ["checkout", "check out", "payment", "billing", "purchase"] },
   // Data categories
-  { category: 'data/table',     keywords: ['table', 'data table', 'spreadsheet', 'grid view', 'list view', 'datagrid'] },
-  { category: 'data/dashboard', keywords: ['dashboard', 'kpi', 'metrics', 'analytics', 'overview', 'summary panel', 'stats'] },
-  { category: 'data/chart',     keywords: ['chart', 'graph', 'visualization', 'pie chart', 'bar chart', 'line chart', 'histogram'] },
-
+  { category: "data/table", keywords: ["table", "data table", "spreadsheet", "grid view", "list view", "datagrid"] },
+  { category: "data/dashboard", keywords: ["dashboard", "kpi", "metrics", "analytics", "overview", "summary panel", "stats"] },
+  { category: "data/chart", keywords: ["chart", "graph", "visualization", "pie chart", "bar chart", "line chart", "histogram"] },
   // Layout categories
-  { category: 'layout/landing', keywords: ['landing', 'landing page', 'homepage', 'hero', 'splash'] },
-  { category: 'layout/profile', keywords: ['profile', 'user profile', 'avatar', 'bio', 'about me'] },
-  { category: 'layout/pricing', keywords: ['pricing', 'pricing table', 'plans', 'subscription', 'tier'] },
-
+  { category: "layout/landing", keywords: ["landing", "landing page", "homepage", "hero", "splash"] },
+  { category: "layout/profile", keywords: ["profile", "user profile", "avatar", "bio", "about me"] },
+  { category: "layout/pricing", keywords: ["pricing", "pricing table", "plans", "subscription", "tier"] },
   // Navigation categories
-  { category: 'nav/sidebar', keywords: ['sidebar', 'side nav', 'navigation menu', 'drawer', 'side panel'] },
-  { category: 'nav/tabs',    keywords: ['tabs', 'tab bar', 'tabbed', 'tab navigation', 'tab panel'] },
-
+  { category: "nav/sidebar", keywords: ["sidebar", "side nav", "navigation menu", "drawer", "side panel"] },
+  { category: "nav/tabs", keywords: ["tabs", "tab bar", "tabbed", "tab navigation", "tab panel"] },
   // Agent categories
-  { category: 'agent/chat',         keywords: ['chat', 'chatbot', 'messenger', 'conversation', 'messaging', 'chat interface'] },
-  { category: 'agent/notification', keywords: ['notification', 'alert', 'toast', 'snackbar', 'banner', 'announcement'] },
-
+  { category: "agent/chat", keywords: ["chat", "chatbot", "messenger", "conversation", "messaging", "chat interface"] },
+  { category: "agent/notification", keywords: ["notification", "alert", "toast", "snackbar", "banner", "announcement"] },
   // Content categories
-  { category: 'content/blog', keywords: ['blog', 'article', 'post', 'news', 'editorial', 'content feed'] },
-  { category: 'content/faq',  keywords: ['faq', 'frequently asked', 'questions', 'help center', 'knowledge base', 'accordion'] },
-
+  { category: "content/blog", keywords: ["blog", "article", "post", "news", "editorial", "content feed"] },
+  { category: "content/faq", keywords: ["faq", "frequently asked", "questions", "help center", "knowledge base", "accordion"] },
   // Commerce categories
-  { category: 'commerce/product', keywords: ['product', 'product card', 'product page', 'product detail', 'item detail', 'catalog'] },
-  { category: 'commerce/cart',    keywords: ['cart', 'shopping cart', 'basket', 'bag'] },
-  { category: 'commerce/order',   keywords: ['order', 'order history', 'order summary', 'receipt', 'invoice', 'order tracking'] },
-
+  { category: "commerce/product", keywords: ["product", "product card", "product page", "product detail", "item detail", "catalog"] },
+  { category: "commerce/cart", keywords: ["cart", "shopping cart", "basket", "bag"] },
+  { category: "commerce/order", keywords: ["order", "order history", "order summary", "receipt", "invoice", "order tracking"] },
   // Workflow categories
-  { category: 'workflow/wizard',  keywords: ['wizard', 'stepper', 'multi-step', 'step form', 'onboard flow', 'setup wizard'] },
-  { category: 'workflow/kanban',  keywords: ['kanban', 'board', 'task board', 'trello', 'project board', 'drag and drop'] },
-
+  { category: "workflow/wizard", keywords: ["wizard", "stepper", "multi-step", "step form", "onboard flow", "setup wizard"] },
+  { category: "workflow/kanban", keywords: ["kanban", "board", "task board", "trello", "project board", "drag and drop"] },
   // Status categories
-  { category: 'status/error',   keywords: ['error', 'error page', '404', '500', 'not found', 'something went wrong'] },
-  { category: 'status/empty',   keywords: ['empty state', 'no results', 'no data', 'zero state', 'blank slate'] },
-  { category: 'status/loading', keywords: ['loading', 'skeleton', 'spinner', 'progress', 'placeholder'] },
+  { category: "status/error", keywords: ["error", "error page", "404", "500", "not found", "something went wrong"] },
+  { category: "status/empty", keywords: ["empty state", "no results", "no data", "zero state", "blank slate"] },
+  { category: "status/loading", keywords: ["loading", "skeleton", "spinner", "progress", "placeholder"] }
 ];
-
-/**
- * Categorize a free-text intent into a UI taxonomy category.
- *
- * @param {string} intent — Free-text intent string
- * @returns {{ category: string, confidence: number }}
- */
-export function categorizeIntent(intent) {
-  if (!intent || typeof intent !== 'string') {
-    return { category: 'other', confidence: 0 };
+function categorizeIntent(intent) {
+  if (!intent || typeof intent !== "string") {
+    return { category: "other", confidence: 0 };
   }
-
   const lower = intent.toLowerCase().trim();
-  let bestCategory = 'other';
+  let bestCategory = "other";
   let bestScore = 0;
-
   for (const rule of CATEGORY_RULES) {
     let matchCount = 0;
     let longestMatch = 0;
-
     for (const kw of rule.keywords) {
       if (lower.includes(kw)) {
         matchCount++;
         longestMatch = Math.max(longestMatch, kw.length);
       }
     }
-
     if (matchCount === 0) continue;
-
-    // Score: multi-word keyword matches get higher confidence,
-    // more matches within a category = higher confidence
-    const kwLenBonus = longestMatch / lower.length; // longer keyword relative to intent = more specific
+    const kwLenBonus = longestMatch / lower.length;
     const multiMatchBonus = Math.min(matchCount * 0.15, 0.3);
     const score = 0.5 + kwLenBonus * 0.3 + multiMatchBonus;
-
     if (score > bestScore) {
       bestScore = score;
       bestCategory = rule.category;
     }
   }
-
   return {
     category: bestCategory,
-    confidence: Math.min(Math.round(bestScore * 100) / 100, 1),
+    confidence: Math.min(Math.round(bestScore * 100) / 100, 1)
   };
 }
+export {
+  categorizeIntent
+};