@adia-ai/a2ui-corpus 0.0.3 → 0.0.5

package/patterns/_index.json

@@ -1,5 +1,5 @@
 {
-  "generated_at": "2026-04-24T16:21:02.400Z",
+  "generated_at": "2026-04-28T05:34:25.731Z",
   "stats": {
     "total": 113,
     "by_domain": {

package/scripts/chunk-library.js

@@ -83,41 +83,90 @@ export function listChunksByKind(kind) {
 }
 
 /**
- * Lightweight keyword search over chunk metadata. Scores against:
- *   - chunk name (exact prefix match weighted highest)
- *   - primary tag name
- *   - cluster prefix (auth-, reg-, dashboard-, etc.)
- *   - slot names within the chunk
+ * Keyword scoring over chunk metadata. Used as the floor when embeddings
+ * are unavailable AND blended into the final score when they are.
+ */
+function keywordScore(name, rec, query) {
+  const q = query.toLowerCase();
+  const tokens = q.split(/[\s\-_]+/).filter(Boolean);
+  const haystack = [
+    name,
+    rec.primary || '',
+    ...(rec.slots || []).map((s) => s.name || ''),
+    ...(rec.instances?.[0]?.slots || []).map((s) => s.name || ''),
+    Object.values(rec.attrs || {}).join(' '),
+  ].join(' ').toLowerCase();
+
+  let score = 0;
+  if (name.toLowerCase().startsWith(q)) score += 10;
+  if (haystack.includes(q)) score += 5;
+  for (const tok of tokens) {
+    if (name.toLowerCase().includes(tok)) score += 2;
+    if (haystack.includes(tok)) score += 1;
+  }
+  return score;
+}
+
+/**
+ * Search chunks. Two-mode:
+ *   - Sync (default): keyword-only scoring; no API calls.
+ *   - Async (`searchChunksAsync`): blends semantic embedding cosine score
+ *     (when chunk-embeddings.json + an OPENAI/VOYAGE key are available)
+ *     with keyword score; falls back to keyword-only on any failure.
  *
- * Not embedding-based — that's a follow-up. Good enough for MVP.
+ * The sync path is preserved for callers that need a synchronous result
+ * (e.g. compose_from_chunks's retrieval-first tier doesn't want to await
+ * a network round trip just to short-circuit on a strong keyword hit).
  */
 export function searchChunks(query, { kind, limit = 20 } = {}) {
   const { chunks } = load();
   if (!query || typeof query !== 'string') return [];
-  const q = query.toLowerCase();
-  const tokens = q.split(/[\s\-_]+/).filter(Boolean);
 
   const candidates = [];
   for (const [name, rec] of chunks) {
     if (kind && rec.kind !== kind) continue;
-    const haystack = [
-      name,
-      rec.primary || '',
-      ...(rec.slots || []).map((s) => s.name || ''),
-      ...(rec.instances?.[0]?.slots || []).map((s) => s.name || ''),
-      Object.values(rec.attrs || {}).join(' '),
-    ].join(' ').toLowerCase();
-
-    let score = 0;
-    if (name.toLowerCase().startsWith(q)) score += 10;
-    if (haystack.includes(q)) score += 5;
-    for (const tok of tokens) {
-      if (name.toLowerCase().includes(tok)) score += 2;
-      if (haystack.includes(tok)) score += 1;
-    }
+    const score = keywordScore(name, rec, query);
     if (score > 0) candidates.push({ name, score, kind: rec.kind, primary: rec.primary });
   }
+  candidates.sort((a, b) => b.score - a.score);
+  return candidates.slice(0, limit);
+}
 
+/**
+ * Embedding-blended search. Returns the top `limit` chunks ranked by
+ * (keyword + 5×cosine) when embeddings are available; falls back to
+ * keyword-only when not. Scoring weights are tuned so a perfect cosine
+ * match (1.0) contributes ~5 to the score, comparable to a name-prefix hit.
+ */
+export async function searchChunksAsync(query, { kind, limit = 20 } = {}) {
+  const { chunks } = load();
+  if (!query || typeof query !== 'string') return [];
+
+  let cosineByName = null;
+  try {
+    const { scoreAll, available } = await import('../../retrieval/chunk-embedding-retriever.js');
+    if (await available()) {
+      cosineByName = await scoreAll(query);
+    }
+  } catch { /* embeddings unavailable — keyword-only */ }
+
+  const candidates = [];
+  for (const [name, rec] of chunks) {
+    if (kind && rec.kind !== kind) continue;
+    const kw = keywordScore(name, rec, query);
+    const cos = cosineByName?.get(name) || 0;
+    const blended = kw + cos * 5;
+    if (blended > 0) {
+      candidates.push({
+        name,
+        score: blended,
+        keywordScore: kw,
+        cosineScore: cos,
+        kind: rec.kind,
+        primary: rec.primary,
+      });
+    }
+  }
   candidates.sort((a, b) => b.score - a.score);
   return candidates.slice(0, limit);
 }

package/chunks/genui-feed-message.json

@@ -1,14 +0,0 @@
-{
-  "name": "genui-feed-message",
-  "kind": "block",
-  "primary": "col-ui",
-  "page": "/site/examples/gen-ui-feed",
-  "slots": [],
-  "nested": [],
-  "attrs": {
-    "gap": "8"
-  },
-  "html": "<col-ui gap=\"8\" id=\"gen-feed\" data-chunk=\"genui-feed-message\">\n\n  <!-- ═══════════ USER TURN 1 ═══════════ -->\n  <article>\n    <row-ui gap=\"2\" align=\"center\">\n      <avatar-ui text=\"Jane Smith\" size=\"sm\"></avatar-ui>\n      <text-ui strong>Jane</text-ui>\n      <text-ui color=\"subtle\">·</text-ui>\n      <text-ui color=\"subtle\">2 min ago</text-ui>\n    </row-ui>\n    <p>Pull our Q4 revenue breakdown — I need to see the trend, the outliers, where the data came from, and a follow-up meeting on the calendar.</p>\n  </article>\n\n  <!-- ═══════════ ASSISTANT TURN 1 ═══════════ -->\n  <article>\n    <row-ui gap=\"2\" align=\"center\">\n      <icon-ui name=\"sparkle\" color=\"accent\"></icon-ui>\n      <text-ui strong>Assistant</text-ui>\n      <text-ui color=\"subtle\">·</text-ui>\n      <text-ui color=\"subtle\">now</text-ui>\n    </row-ui>\n\n    <col-ui gap=\"4\">\n\n      <!-- (5) Alert — info banner -->\n      <alert-ui\n        variant=\"info\"\n        icon=\"info\"\n        text=\"Pulled from the finance warehouse as of today 09:12 UTC. Figures are unaudited.\"\n      ></alert-ui>\n\n      <!-- (1) Reasoning trace -->\n      <agent-reasoning-ui\n        id=\"reasoning-1\"\n        heading=\"Analyzing the request\"\n        collapsed\n        no-autocollapse\n      ></agent-reasoning-ui>\n\n      <!-- (6) Pipeline status -->\n      <pipeline-status-ui stage=\"parsing\"   status=\"completed\" message=\"Parsing intent\"></pipeline-status-ui>\n      <pipeline-status-ui stage=\"retrieval\" status=\"completed\" message=\"Retrieving data\"></pipeline-status-ui>\n      <pipeline-status-ui stage=\"rendering\"          message=\"Rendering\"></pipeline-status-ui>\n\n      <!-- (2) Tool call — accordion with status header + json body -->\n      <accordion-ui>\n        <accordion-item-ui>\n          <span slot=\"trigger\">\n            <row-ui gap=\"2\" align=\"center\">\n              <icon-ui name=\"check-circle\" color=\"success\"></icon-ui>\n              <text-ui strong>get_revenue</text-ui>\n              <text-ui color=\"subtle\">returned 4 rows · 340ms</text-ui>\n              <badge-ui text=\"DONE\" variant=\"success\"></badge-ui>\n            </row-ui>\n          </span>\n          <code-ui language=\"json\" text='{\n  \"from\":  \"2025-01-01\",\n  \"to\":    \"2025-12-31\",\n  \"group\": \"quarter\"\n}'></code-ui>\n        </accordion-item-ui>\n      </accordion-ui>\n\n      <!-- (4) Metrics trace -->\n      <agent-trace-ui id=\"trace-1\"></agent-trace-ui>\n\n      <!-- (7) KPI stat grid -->\n      <grid-ui columns=\"4\" gap=\"4\">\n        <card-ui size=\"sm\"><section><stat-ui label=\"Q4 Revenue\"   value=\"$2.45M\" change=\"+23%\"  trend=\"up\"   icon=\"currency-dollar\"></stat-ui></section></card-ui>\n        <card-ui size=\"sm\"><section><stat-ui label=\"Net New ARR\"  value=\"$580K\"  change=\"+41%\"  trend=\"up\"   icon=\"chart-line-up\"></stat-ui></section></card-ui>\n        <card-ui size=\"sm\"><section><stat-ui label=\"Gross Margin\" value=\"78.2%\"  change=\"+1.4%\" trend=\"up\"   icon=\"percent\"></stat-ui></section></card-ui>\n        <card-ui size=\"sm\"><section><stat-ui label=\"Churn\"        value=\"3.1%\"   change=\"-0.6%\" trend=\"down\" icon=\"trend-down\"></stat-ui></section></card-ui>\n      </grid-ui>\n\n      <!-- (8) Chart card -->\n      <card-ui>\n        <header>\n          <h3>Revenue by quarter</h3>\n          <text-ui slot=\"description\" color=\"subtle\" size=\"sm\">4-quarter rolling trend, all regions</text-ui>\n        </header>\n        <section>\n          <chart-ui id=\"chart-rev\" type=\"bar\" x=\"label\" y=\"value\"></chart-ui>\n        </section>\n      </card-ui>\n\n      <!-- (10) Heatmap -->\n      <card-ui>\n        <header>\n          <h3>Deal closes · last 90 days</h3>\n          <text-ui slot=\"description\" color=\"subtle\" size=\"sm\">Each cell = one weekday</text-ui>\n        </header>\n        <section>\n          <heatmap-ui id=\"hm-closes\" type=\"day-grid\" rows=\"7\" cols=\"13\" start-date=\"2025-10-20\"></heatmap-ui>\n        </section>\n      </card-ui>\n\n      <!-- (9) Data table -->\n      <card-ui>\n        <header>\n          <h3>Top accounts this quarter</h3>\n          <text-ui slot=\"description\" color=\"subtle\" size=\"sm\">Sorted by revenue · click to drill</text-ui>\n        </header>\n        <section bleed>\n          <table-ui id=\"top-accounts\" paginate=\"5\"></table-ui>\n        </section>\n      </card-ui>\n\n      <!-- (11) Description list -->\n      <card-ui>\n        <header>\n          <h3>Query parameters</h3>\n        </header>\n        <section>\n          <description-list-ui layout=\"stacked\">\n            <dt>Period</dt><dd>2025-01-01 → 2025-12-31</dd>\n            <dt>Currency</dt><dd>USD, converted at month-end FX</dd>\n            <dt>Source</dt><dd>warehouse.finance.revenue_v4</dd>\n            <dt>Filter</dt><dd>status = \"won\", excluded internal test accounts</dd>\n            <dt>Refreshed</dt><dd>2026-04-20 09:12 UTC</dd>\n          </description-list-ui>\n        </section>\n      </card-ui>\n\n      <!-- (14) Code block — the SQL behind the answer -->\n      <code-ui\n        language=\"sql\"\n        text='SELECT\n  date_trunc(quarter, closed_at)  AS quarter,\n  sum(amount_usd)                 AS revenue,\n  count(distinct account_id)      AS accounts\nFROM warehouse.finance.revenue_v4\nWHERE status = \"won\"\n  AND closed_at BETWEEN \"2025-01-01\" AND \"2025-12-31\"\nGROUP BY 1\nORDER BY 1;'\n      ></code-ui>\n\n      <!-- (12) Citations row — chips of sources -->\n      <row-ui gap=\"2\" wrap>\n        <tag-ui text=\"¹ warehouse.revenue_v4\"></tag-ui>\n        <tag-ui text=\"² salesforce.opportunity\"></tag-ui>\n        <tag-ui text=\"³ board-prep.notion.so\"></tag-ui>\n        <tag-ui text=\"⁴ q4-cohort-analysis\"></tag-ui>\n      </row-ui>\n\n      <!-- (18) Follow-up suggestions -->\n      <agent-suggestions-ui id=\"sug-1\"></agent-suggestions-ui>\n\n    </col-ui>\n  </article>\n\n  <!-- ═══════════ USER TURN 2 ═══════════ -->\n  <article>\n    <row-ui gap=\"2\" align=\"center\">\n      <avatar-ui text=\"Jane Smith\" size=\"sm\"></avatar-ui>\n      <text-ui strong>Jane</text-ui>\n      <text-ui color=\"subtle\">·</text-ui>\n      <text-ui color=\"subtle\">just now</text-ui>\n    </row-ui>\n    <p>Great — drop the regional photos in too, plus a link to last quarter's prep notes, the field-visit map, and a draft for the board email. Then schedule the review meeting.</p>\n  </article>\n\n  <!-- ═══════════ ASSISTANT TURN 2 ═══════════ -->\n  <article>\n    <row-ui gap=\"2\" align=\"center\">\n      <icon-ui name=\"sparkle\" color=\"accent\"></icon-ui>\n      <text-ui strong>Assistant</text-ui>\n      <text-ui color=\"subtle\">·</text-ui>\n      <text-ui color=\"subtle\">now</text-ui>\n    </row-ui>\n\n    <col-ui gap=\"4\">\n\n      <!-- (15) Image grid -->\n      <grid-ui columns=\"3\" gap=\"3\">\n        <image-ui src=\"https://picsum.photos/seed/rev-1/480/320\" alt=\"Quarterly chart export\" radius=\"md\" style=\"aspect-ratio:3/2\"></image-ui>\n        <image-ui src=\"https://picsum.photos/seed/rev-2/480/320\" alt=\"Top account visualization\" radius=\"md\" style=\"aspect-ratio:3/2\"></image-ui>\n        <image-ui src=\"https://picsum.photos/seed/rev-3/480/320\" alt=\"Regional breakdown\" radius=\"md\" style=\"aspect-ratio:3/2\"></image-ui>\n      </grid-ui>\n\n      <!-- (13) Link preview — card with media slot -->\n      <card-ui>\n        <image-ui slot=\"media\" src=\"https://picsum.photos/seed/q4-prep/960/360\" alt=\"\" style=\"aspect-ratio:8/3\"></image-ui>\n        <header>\n          <h3>Q4 Board Prep — Revenue & Outlook Draft</h3>\n          <text-ui slot=\"description\" color=\"subtle\" size=\"sm\">confluence.internal · 6 min read</text-ui>\n        </header>\n        <section>\n          <text-ui>Sarah Chen's shared draft covers ARR trajectory, cohort retention, and the segmentation the board will want to see.</text-ui>\n        </section>\n      </card-ui>\n\n      <!-- (16) Map + list -->\n      <grid-ui columns=\"5\" gap=\"4\">\n        <image-ui span=\"3\" src=\"https://picsum.photos/seed/map-q4/640/480\" alt=\"Map of field-visit locations\" radius=\"md\" style=\"aspect-ratio:4/3\"></image-ui>\n        <card-ui span=\"2\">\n          <header>\n            <h3>Field visits · Q4</h3>\n          </header>\n          <section>\n            <list-ui divider>\n              <list-item-ui>\n                <row-ui gap=\"2\" align=\"center\">\n                  <icon-ui name=\"map-pin\" color=\"accent\"></icon-ui>\n                  <col-ui gap=\"0\">\n                    <text-ui strong>San Francisco</text-ui>\n                    <text-ui color=\"subtle\" size=\"sm\">Acme Corp · Globex · 3 more</text-ui>\n                  </col-ui>\n                </row-ui>\n              </list-item-ui>\n              <list-item-ui>\n                <row-ui gap=\"2\" align=\"center\">\n                  <icon-ui name=\"map-pin\" color=\"accent\"></icon-ui>\n                  <col-ui gap=\"0\">\n                    <text-ui strong>New York</text-ui>\n                    <text-ui color=\"subtle\" size=\"sm\">Stark Industries · 2 more</text-ui>\n                  </col-ui>\n                </row-ui>\n              </list-item-ui>\n              <list-item-ui>\n                <row-ui gap=\"2\" align=\"center\">\n                  <icon-ui name=\"map-pin\" color=\"accent\"></icon-ui>\n                  <col-ui gap=\"0\">\n                    <text-ui strong>London</text-ui>\n                    <text-ui color=\"subtle\" size=\"sm\">Umbrella Corp</text-ui>\n                  </col-ui>\n                </row-ui>\n              </list-item-ui>\n              <list-item-ui>\n                <row-ui gap=\"2\" align=\"center\">\n                  <icon-ui name=\"map-pin\" color=\"accent\"></icon-ui>\n                  <col-ui gap=\"0\">\n                    <text-ui strong>Berlin</text-ui>\n                    <text-ui color=\"subtle\" size=\"sm\">Wayne Enterprises</text-ui>\n                  </col-ui>\n                </row-ui>\n              </list-item-ui>\n            </list-ui>\n          </section>\n        </card-ui>\n      </grid-ui>\n\n      <!-- (3) Artifact stub — promoted to canvas -->\n      <card-ui>\n        <section>\n          <row-ui gap=\"3\" align=\"center\">\n            <icon-ui name=\"file-code\" color=\"accent\"></icon-ui>\n            <col-ui gap=\"0\" grow>\n              <text-ui strong>q4-board-deck.a2ui</text-ui>\n              <text-ui color=\"subtle\" size=\"sm\">A2UI · 42 lines · interactive</text-ui>\n            </col-ui>\n            <button-ui text=\"Open in canvas\" icon=\"arrows-out-simple\" variant=\"outline\" size=\"sm\"></button-ui>\n          </row-ui>\n        </section>\n      </card-ui>\n\n      <!-- (3b) Artifact — inline expanded -->\n      <agent-artifact-ui title=\"q4-followup.js\" kind=\"code\" icon=\"file-code\" tone=\"accent\">\n        <button-ui slot=\"secondary\" text=\"Copy\" icon=\"copy\" variant=\"ghost\" size=\"sm\"></button-ui>\n        <code-ui language=\"js\" text='// Email draft — send after the sync\nexport const message = {\n  to:      [\"board@acme.io\"],\n  subject: \"Q4 revenue & outlook — pre-read\",\n  body: `\n    Q4 came in at $2.45M (+23% QoQ).\n    Top 10 accounts contributed 62% of net-new ARR.\n    Detailed breakdown in the attached doc.\n    - Sarah\n  `.trim(),\n};'></code-ui>\n      </agent-artifact-ui>\n\n      <!-- (17) Form — schedule a review meeting -->\n      <card-ui>\n        <header>\n          <h3>Schedule review meeting</h3>\n          <text-ui slot=\"description\" color=\"subtle\" size=\"sm\">I'll send the invite once you confirm</text-ui>\n        </header>\n        <section>\n          <col-ui gap=\"3\">\n            <field-ui label=\"Title\">\n              <input-ui value=\"Q4 revenue review · board prep\"></input-ui>\n            </field-ui>\n            <row-ui gap=\"3\">\n              <field-ui label=\"Date\">\n                <calendar-picker-ui value=\"2026-04-24\" grow></calendar-picker-ui>\n              </field-ui>\n              <field-ui label=\"Time\">\n                <select-ui grow>\n                <option value=\"09:00\">9:00 AM</option>\n                <option value=\"10:00\">10:00 AM</option>\n                <option value=\"14:00\" selected>2:00 PM</option>\n                <option value=\"16:00\">4:00 PM</option>\n              </select-ui>\n              </field-ui>\n            </row-ui>\n            <field-ui label=\"Attendees\">\n              <input-ui value=\"sarah@acme.io, alex@acme.io, board@acme.io\"></input-ui>\n            </field-ui>\n            <field-ui label=\"Attach Q4 revenue deck\" inline>\n              <check-ui checked></check-ui>\n            </field-ui>\n          </col-ui>\n        </section>\n        <footer divider>\n          <small slot=\"description\">Invite sends immediately after confirm.</small>\n          <span slot=\"action\">\n            <button-ui text=\"Cancel\" variant=\"ghost\"></button-ui>\n            <button-ui text=\"Send invite\" variant=\"primary\" icon=\"paper-plane-tilt\"></button-ui>\n          </span>\n        </footer>\n      </card-ui>\n\n      <!-- (18) Follow-up suggestions -->\n      <agent-suggestions-ui id=\"sug-2\"></agent-suggestions-ui>\n\n    </col-ui>\n  </article>\n\n</col-ui>",
-  "source": "site/pages/examples/gen-ui-feed/index.html",
-  "captured_at": "2026-04-28T04:46:20.743Z"
-}