@adia-ai/a2ui-retrieval

Retrieval layer for the A2UI (Agent-to-UI) protocol — catalog lookup, intent classification, domain routing, pattern + anti-pattern matching, clarity + context assembly. Consumed by @adia-ai/a2ui-compose and any A2UI-protocol tooling that needs to reason about user intent against the catalog.

Install

npm install @adia-ai/a2ui-retrieval

What's here

The package groups its 26 source files into 4 sub-concerns plus a top-level lookup surface. Importers can pull the top-level barrel (@adia-ai/a2ui-retrieval) for the previously-public surface, the per-subdir barrels (@adia-ai/a2ui-retrieval/intent etc.), or individual files for fine-grained imports.

a2ui-retrieval/
├── catalog.js              top-level — catalog lookup (loaded from corpus)
├── pattern-library.js      top-level — keyword + semantic pattern search
├── concept-mapper.js       top-level — concept → catalog-entry mapping
├── domain-router.js        top-level — intent → catalog-domain classifier
├── wiring-catalog.js       top-level — controller / handler reference
├── anti-patterns.js        top-level — known-bad pattern detector
├── context-assembler.js    top-level — retrieval results → LLM context
├── component-entry.js      top-level — catalog row serializer
├── index.js                top-level — barrel
│
├── intent/                 intent classification + decomposition
│   ├── intent-alignment.js
│   ├── intent-categorizer.js
│   ├── intent-gate.js          UI-generating vs conversational
│   ├── prompt-analyzer.js
│   ├── decomposer.js           compound intents → subtasks
│   └── clarity.js              clarity scoring
│
├── embedding/              dense-vector retrieval
│   ├── embedding-provider.js   adapter (Voyage / OpenAI / fallback)
│   ├── embedding-retriever.js  top-N pattern retrieval
│   └── chunk-embedding-retriever.js  chunk-level retrieval
│
├── feedback/               user-feedback ingestion loop
│   ├── feedback.js
│   ├── feedback-store.js       JSONL store under .brain/feedback/
│   ├── feedback-analyzer.js
│   ├── dialog-recorder.js      LLM round-trip capture (gated by env)
│   └── gap-registry.js         tracked gaps in catalog coverage
│
└── authoring/              corpus-authoring helpers (upstream of retrieval)
    ├── synthetic-data.js
    ├── web-research.js
    └── pattern-promotion.js

Runtime

Framework-agnostic JS. Depends only on @adia-ai/a2ui-runtime for the A2UI registry + runtime primitives.

Links

• Repo: adiahealth/gen-ui-kit
• Architecture: docs/specs/package-architecture.md
• CHANGELOG: CHANGELOG.md