@adia-ai/a2ui-retrieval 0.6.4 → 0.6.7

package/wiring-catalog.js

@@ -1,195 +1,144 @@
-/**
- * Wiring Catalog — Knowledge base for the gen-ui pipeline.
- *
- * Indexes available wiring capabilities so the generator can emit valid
- * wireComponents declarations alongside component trees.
- *
- * The schema has 5 docking points:
- *   DATA     — sources, params (how the surface gets its data)
- *   STATE    — controllers, model (how components manage behavior)
- *   ACTIONS  — UIEvent → handler chains (what happens on events)
- *   PROVIDES — context injection into subtrees
- *   LIFECYCLE — onMount, onUnmount, onModelChange hooks
- *
- * Each point is optional. A static display surface needs none.
- * A form needs STATE (FormController) + ACTIONS (submit).
- * A dashboard needs DATA (sources) + STATE (DataStreamController).
- * A full app needs all five.
- */
-
-// ── UIEvent ──────────────────────────────────────────────────
-// A typed event object that the wiring system understands natively.
-// Maps 1:1 to DOM events but with AdiaUI semantics and payload contracts.
-//
-//   { "event": "press",  "target": "save-btn" }
-//   { "event": "input",  "target": "search",  "debounce": 300 }
-//   { "event": "submit", "target": "form-col" }
-//   { "event": "mount" }
-//
-// "event"    — UIEvent type name (see adiaEvents below)
-// "target"   — component id that emits. Omit for surface-level events.
-// "debounce" — ms, coalesce rapid-fire (input, resize)
-// "throttle" — ms, limit frequency (scroll, drag)
-// "condition" — guard: { path, equals|notEquals|exists }
-
 const adiaEvents = [
-  { event: 'press',    payload: null,           description: 'Button or interactive element activated.' },
-  { event: 'submit',   payload: 'form-values',  description: 'Form submission with validated field values.' },
-  { event: 'input',    payload: 'target-value',  description: 'Value changed (fires on every keystroke).' },
-  { event: 'change',   payload: 'event-detail',  description: 'Value committed (fires on blur or selection).' },
-  { event: 'select',   payload: 'event-detail',  description: 'Item selected from list, table, or menu.' },
-  { event: 'toggle',   payload: 'boolean',       description: 'Boolean state flipped (switch, checkbox).' },
-  { event: 'dismiss',  payload: null,            description: 'Close/dismiss (dialog, toast, popover).' },
-  { event: 'navigate', payload: 'route',         description: 'Internal navigation request.' },
-  { event: 'mount',    payload: null,            description: 'Surface or component entered the DOM.' },
-  { event: 'unmount',  payload: null,            description: 'Surface or component left the DOM.' },
-  { event: 'focus',    payload: null,            description: 'Element received focus.' },
-  { event: 'blur',     payload: null,            description: 'Element lost focus.' },
-  { event: 'drag',     payload: 'event-detail',  description: 'Drag operation on a sortable/draggable.' },
-  { event: 'drop',     payload: 'event-detail',  description: 'Drop completed on a sortable/draggable.' },
+  { event: "press", payload: null, description: "Button or interactive element activated." },
+  { event: "submit", payload: "form-values", description: "Form submission with validated field values." },
+  { event: "input", payload: "target-value", description: "Value changed (fires on every keystroke)." },
+  { event: "change", payload: "event-detail", description: "Value committed (fires on blur or selection)." },
+  { event: "select", payload: "event-detail", description: "Item selected from list, table, or menu." },
+  { event: "toggle", payload: "boolean", description: "Boolean state flipped (switch, checkbox)." },
+  { event: "dismiss", payload: null, description: "Close/dismiss (dialog, toast, popover)." },
+  { event: "navigate", payload: "route", description: "Internal navigation request." },
+  { event: "mount", payload: null, description: "Surface or component entered the DOM." },
+  { event: "unmount", payload: null, description: "Surface or component left the DOM." },
+  { event: "focus", payload: null, description: "Element received focus." },
+  { event: "blur", payload: null, description: "Element lost focus." },
+  { event: "drag", payload: "event-detail", description: "Drag operation on a sortable/draggable." },
+  { event: "drop", payload: "event-detail", description: "Drop completed on a sortable/draggable." }
 ];
-
-/**
- * Get the full wiring catalog.
- * @returns {object}
- */
-export function getWiringCatalog() {
+function getWiringCatalog() {
   return {
     // ── ADIA EVENTS ──
     adiaEvents,
-
     // ── DATA: how the surface gets its data ──
     data: {
-      description: 'Fetch external data into the surface model. Sources are URI-based with refresh strategies.',
-      paramSources: ['route', 'store', 'literal', 'query', 'parent'],
-      uriSchemes: ['resource://', 'api://', 'mock://', 'ws://', 'sse://'],
-      refreshStrategies: ['once', 'on-focus', 'interval:{ms}', 'stream'],
+      description: "Fetch external data into the surface model. Sources are URI-based with refresh strategies.",
+      paramSources: ["route", "store", "literal", "query", "parent"],
+      uriSchemes: ["resource://", "api://", "mock://", "ws://", "sse://"],
+      refreshStrategies: ["once", "on-focus", "interval:{ms}", "stream"],
       example: {
-        params: { userId: { from: 'route', key: 'id' } },
+        params: { userId: { from: "route", key: "id" } },
         sources: [
-          { id: 'user', uri: 'resource://users/{userId}', path: '/user', refresh: 'once' },
-          { id: 'activity', uri: 'resource://users/{userId}/activity', path: '/activity', refresh: 'on-focus' },
-        ],
-      },
+          { id: "user", uri: "resource://users/{userId}", path: "/user", refresh: "once" },
+          { id: "activity", uri: "resource://users/{userId}/activity", path: "/activity", refresh: "on-focus" }
+        ]
+      }
     },
-
     // ── STATE: controllers that manage component behavior ──
     controllers: [
       {
-        type: 'FormController',
-        description: 'Manages field values, validation, dirty/pristine tracking. Attach to a Column/Section containing form fields.',
+        type: "FormController",
+        description: "Manages field values, validation, dirty/pristine tracking. Attach to a Column/Section containing form fields.",
         config: {
-          validateOn: { type: 'string', enum: ['blur', 'change', 'submit'], default: 'blur' },
+          validateOn: { type: "string", enum: ["blur", "change", "submit"], default: "blur" }
         },
-        commands: ['validate', 'reset', 'setFieldError'],
-        bind: { values: '/form/values', valid: '/form/valid', dirty: '/form/dirty' },
+        commands: ["validate", "reset", "setFieldError"],
+        bind: { values: "/form/values", valid: "/form/valid", dirty: "/form/dirty" }
       },
       {
-        type: 'DataStreamController',
-        description: 'Live data buffer for charts, tables, feeds. Supports push, SSE, WebSocket, polling.',
+        type: "DataStreamController",
+        description: "Live data buffer for charts, tables, feeds. Supports push, SSE, WebSocket, polling.",
         config: {
-          max: { type: 'number', default: 100, description: 'FIFO buffer size' },
-          throttle: { type: 'number', default: 0, description: 'Min ms between renders' },
+          max: { type: "number", default: 100, description: "FIFO buffer size" },
+          throttle: { type: "number", default: 0, description: "Min ms between renders" }
         },
-        commands: ['push', 'pushMany', 'connect', 'poll', 'consume', 'stop', 'clear'],
-        bind: { data: '/stream/data', status: '/stream/status' },
+        commands: ["push", "pushMany", "connect", "poll", "consume", "stop", "clear"],
+        bind: { data: "/stream/data", status: "/stream/status" }
       },
       {
-        type: 'SelectionController',
-        description: 'Single or multi-select state for lists, tables, grids.',
-        config: { mode: { type: 'string', enum: ['single', 'multi'], default: 'single' } },
-        commands: ['select', 'deselect', 'toggle', 'selectAll', 'clear'],
-        bind: { selected: '/selection/items', count: '/selection/count' },
+        type: "SelectionController",
+        description: "Single or multi-select state for lists, tables, grids.",
+        config: { mode: { type: "string", enum: ["single", "multi"], default: "single" } },
+        commands: ["select", "deselect", "toggle", "selectAll", "clear"],
+        bind: { selected: "/selection/items", count: "/selection/count" }
       },
       {
-        type: 'ToggleController',
-        description: 'Boolean on/off state with attribute reflection.',
+        type: "ToggleController",
+        description: "Boolean on/off state with attribute reflection.",
         config: {},
-        commands: ['toggle', 'set'],
-        bind: { value: '/toggle/on' },
+        commands: ["toggle", "set"],
+        bind: { value: "/toggle/on" }
       },
       {
-        type: 'AccordionController',
-        description: 'Panel expand/collapse with mutual exclusion.',
-        config: { multiple: { type: 'boolean', default: false } },
-        commands: ['open', 'close', 'toggle'],
-        bind: { openPanels: '/accordion/open' },
-      },
+        type: "AccordionController",
+        description: "Panel expand/collapse with mutual exclusion.",
+        config: { multiple: { type: "boolean", default: false } },
+        commands: ["open", "close", "toggle"],
+        bind: { openPanels: "/accordion/open" }
+      }
     ],
-
     // ── ACTIONS: event → handler chains ──
     handlers: [
-      { name: 'submit-resource', description: 'POST/PUT/PATCH/DELETE to a resource URI.', config: ['uri', 'method', 'body'] },
-      { name: 'update-model', description: 'Update the surface data model at a path.', config: ['path', 'value'] },
-      { name: 'navigate', description: 'Route to a path (supports {param} templates).', config: ['navigate'] },
-      { name: 'navigate-back', description: 'Go back in browser history.', config: [] },
-      { name: 'controller-command', description: 'Invoke a command on a controller.', config: ['controllerId', 'command', 'args'] },
-      { name: 'emit-event', description: 'Dispatch a named CustomEvent on the surface.', config: ['eventName', 'detail'] },
-      { name: 'refresh-source', description: 'Re-fetch a named data source.', config: ['sourceId'] },
-      { name: 'notify', description: 'Show a toast/alert notification.', config: ['message', 'variant'] },
+      { name: "submit-resource", description: "POST/PUT/PATCH/DELETE to a resource URI.", config: ["uri", "method", "body"] },
+      { name: "update-model", description: "Update the surface data model at a path.", config: ["path", "value"] },
+      { name: "navigate", description: "Route to a path (supports {param} templates).", config: ["navigate"] },
+      { name: "navigate-back", description: "Go back in browser history.", config: [] },
+      { name: "controller-command", description: "Invoke a command on a controller.", config: ["controllerId", "command", "args"] },
+      { name: "emit-event", description: "Dispatch a named CustomEvent on the surface.", config: ["eventName", "detail"] },
+      { name: "refresh-source", description: "Re-fetch a named data source.", config: ["sourceId"] },
+      { name: "notify", description: "Show a toast/alert notification.", config: ["message", "variant"] }
     ],
-
     // ── ACTION SHAPE (UIEvent → handler) ──
     actionShape: {
-      event: 'UIEvent object: { event, target?, debounce?, throttle?, condition? }',
-      handler: 'Handler name from the handlers list.',
-      config: 'Handler-specific configuration object.',
-      onSuccess: 'Follow-up actions array (each is { handler, config }).',
-      onError: 'Follow-up actions array on failure.',
+      event: "UIEvent object: { event, target?, debounce?, throttle?, condition? }",
+      handler: "Handler name from the handlers list.",
+      config: "Handler-specific configuration object.",
+      onSuccess: "Follow-up actions array (each is { handler, config }).",
+      onError: "Follow-up actions array on failure."
     },
-
     // ── PROVIDES: context injection ──
     provides: {
-      description: 'Inject shared state into a component subtree via a2ui-provider. Children consume via context name.',
-      example: { name: 'auth', host: 'root', value: { user: null, token: null } },
+      description: "Inject shared state into a component subtree via a2ui-provider. Children consume via context name.",
+      example: { name: "auth", host: "root", value: { user: null, token: null } }
     },
-
     // ── LIFECYCLE hooks ──
     lifecycle: {
-      onMount: 'Actions to run when the surface first renders (fetch initial data, start streams).',
-      onUnmount: 'Cleanup actions when the surface is destroyed (close WebSocket, stop polling).',
-      onModelChange: 'Watch a model path and fire actions when it changes (debounce supported).',
+      onMount: "Actions to run when the surface first renders (fetch initial data, start streams).",
+      onUnmount: "Cleanup actions when the surface is destroyed (close WebSocket, stop polling).",
+      onModelChange: "Watch a model path and fire actions when it changes (debounce supported)."
     },
-
     // ── VALUE EXTRACTION (how actions read data) ──
     valueSources: [
-      { from: 'event-detail', description: 'Read from event.detail (key = property)' },
-      { from: 'event-target', description: 'Read from event.target (key = property, e.g., value)' },
-      { from: 'model', description: 'Read from data model (path = JSON Pointer)' },
-      { from: 'literal', description: 'Static value (value = the value)' },
-      { from: 'param', description: 'Read from resolved parameters (key = param name)' },
-      { from: 'controller', description: 'Read from a controller state (controllerId + key)' },
+      { from: "event-detail", description: "Read from event.detail (key = property)" },
+      { from: "event-target", description: "Read from event.target (key = property, e.g., value)" },
+      { from: "model", description: "Read from data model (path = JSON Pointer)" },
+      { from: "literal", description: "Static value (value = the value)" },
+      { from: "param", description: "Read from resolved parameters (key = param name)" },
+      { from: "controller", description: "Read from a controller state (controllerId + key)" }
     ],
-
     // ── MULTI-SURFACE ASSOCIATIONS ──
     associations: [
-      { name: 'routes-to', description: 'Navigation — source links to target.' },
-      { name: 'feeds', description: 'Data flow — source output → target input.' },
-      { name: 'shares-context', description: 'Shared state — both read/write same context.' },
-      { name: 'depends-on', description: 'Lifecycle — source waits for target.' },
-      { name: 'triggers', description: 'Side effect — source event → target update.' },
-      { name: 'contains', description: 'Composition — target renders inside source.' },
-    ],
+      { name: "routes-to", description: "Navigation \u2014 source links to target." },
+      { name: "feeds", description: "Data flow \u2014 source output \u2192 target input." },
+      { name: "shares-context", description: "Shared state \u2014 both read/write same context." },
+      { name: "depends-on", description: "Lifecycle \u2014 source waits for target." },
+      { name: "triggers", description: "Side effect \u2014 source event \u2192 target update." },
+      { name: "contains", description: "Composition \u2014 target renders inside source." }
+    ]
   };
 }
-
-/**
- * Get UIEvent type info.
- */
-export function getAdiaEvent(type) {
-  return adiaEvents.find(e => e.event === type) || null;
+function getAdiaEvent(type) {
+  return adiaEvents.find((e) => e.event === type) ?? void 0;
 }
-
-/**
- * Get controller catalog entry by type name.
- */
-export function getControllerInfo(type) {
-  return getWiringCatalog().controllers.find(c => c.type === type) || null;
+function getControllerInfo(type) {
+  const catalog = getWiringCatalog();
+  return catalog["controllers"].find((c) => c.type === type) ?? void 0;
 }
-
-/**
- * Get handler catalog entry by name.
- */
-export function getHandlerInfo(name) {
-  return getWiringCatalog().handlers.find(h => h.name === name) || null;
+function getHandlerInfo(name) {
+  const catalog = getWiringCatalog();
+  return catalog["handlers"].find((h) => h.name === name) ?? void 0;
 }
+export {
+  getAdiaEvent,
+  getControllerInfo,
+  getHandlerInfo,
+  getWiringCatalog
+};

package/embedding/chunk-embedding-retriever.ts

@@ -1,156 +0,0 @@
-/**
- * Chunk embedding retriever — loads the build-time chunk embedding index
- * and scores a query against every chunk via cosine similarity.
- *
- * Sibling to `embedding-retriever.js` (pattern embeddings); same provider
- * conventions, same graceful-degradation contract.
- *
- * Index: packages/a2ui/corpus/chunk-embeddings.json (built by
- * scripts/build/embeddings-chunks.mjs). When missing or empty, the
- * retriever is effectively a no-op — callers see an empty score map and
- * should fall back to keyword-only ranking.
- *
- * Used by chunk-library.searchChunks() to blend semantic + keyword scores.
- */
-
-import { detectProvider, cosine, voyage, openai } from './embedding-provider.js';
-import type { EmbedFn } from './embedding-provider.js';
-
-// `process` is not in scope under "types": []
-declare const process: { versions?: { node?: string } } | undefined;
-
-const IS_NODE = typeof process !== 'undefined' && !!process.versions?.node;
-
-type ChunkEntry = {
-  name: string;
-  vector: number[];
-};
-
-type ChunkIndex = {
-  chunks?: ChunkEntry[];
-  provider?: string;
-  model?: string;
-  dims?: number;
-};
-
-let _index: ChunkIndex | null = null;
-let _indexByName: Map<string, Float32Array> | null = null; // Map<chunk-name, Float32Array>
-let _loadPromise: Promise<ChunkIndex | null> | null = null;
-let _embedFn: EmbedFn | null = null;
-let _available: boolean | null = null;
-
-async function _loadIndex(): Promise<ChunkIndex | null> {
-  if (_index !== null) return _index;
-  if (_loadPromise) return _loadPromise;
-  _loadPromise = (async () => {
-    try {
-      if (IS_NODE) {
-        const fs = await import(/* @vite-ignore */ 'node:fs/promises');
-        const path = await import(/* @vite-ignore */ 'node:path');
-        const url = await import(/* @vite-ignore */ 'node:url');
-        let p: string | null = null;
-        try {
-          const { createRequire } = await import(/* @vite-ignore */ 'node:module');
-          const require = createRequire(import.meta.url);
-          p = require.resolve('@adia-ai/a2ui-corpus/chunk-embeddings');
-        } catch {
-          const here = path.dirname(url.fileURLToPath(import.meta.url));
-          p = path.resolve(here, '../../corpus/chunk-embeddings.json');
-        }
-        const raw = await fs.readFile(p, 'utf8');
-        _index = JSON.parse(raw) as ChunkIndex;
-      } else {
-        const url = new URL('../../corpus/chunk-embeddings.json', import.meta.url);
-        const res = await fetch(url).catch(() => null);
-        _index = res?.ok ? await res.json().catch(() => null) as ChunkIndex : null;
-      }
-    } catch {
-      _index = null;
-    }
-    if (_index?.chunks?.length) {
-      _indexByName = new Map();
-      for (const c of _index.chunks) {
-        if (c?.name && Array.isArray(c.vector)) {
-          _indexByName.set(c.name, Float32Array.from(c.vector));
-        }
-      }
-    }
-    return _index;
-  })();
-  return _loadPromise;
-}
-
-function _resolveEmbed(providerName: string | undefined, model: string | undefined): EmbedFn | null {
-  // The index's recorded (provider, model) is the source of truth — query
-  // embeddings MUST be generated by the same model the corpus was indexed with.
-  let fn: EmbedFn | null = null;
-  if (providerName === 'voyage') fn = voyage({ model });
-  else if (providerName === 'openai') fn = openai({ model });
-  else {
-    // No provider recorded in index header (legacy index?). Fall back to auto-detect.
-    const auto = detectProvider();
-    return auto?.embed ?? null;
-  }
-  if (!fn && typeof console !== 'undefined') {
-    console.warn(
-      `[chunk-embedding-retriever] index was built with provider=${providerName} model=${model}, ` +
-      `but the corresponding API key is not set. Embeddings will be unavailable; falling back to ` +
-      `keyword-only retrieval. Set the matching API key, or rebuild the index with the available ` +
-      `provider via \`npm run build:embeddings:chunks\`.`
-    );
-  }
-  return fn;
-}
-
-export async function available(): Promise<boolean> {
-  if (_available !== null) return _available;
-  const idx = await _loadIndex();
-  if (!idx || !idx.chunks?.length) {
-    _available = false;
-    return false;
-  }
-  _embedFn = _resolveEmbed(idx.provider, idx.model);
-  _available = !!_embedFn;
-  return _available;
-}
-
-/**
- * Embed a query and return a Map<chunk-name → cosine-score>.
- * Returns an empty Map when unavailable (no index or no API key).
- */
-export async function scoreAll(query: string): Promise<Map<string, number>> {
-  if (!query || typeof query !== 'string') return new Map();
-  if (!(await available())) return new Map();
-
-  let qVec: Float32Array;
-  try {
-    const [v] = await _embedFn!([query]);
-    qVec = v!;
-  } catch (e) {
-    if (typeof console !== 'undefined') console.warn('[chunk-embedding-retriever]', (e as Error).message);
-    return new Map();
-  }
-
-  const out = new Map<string, number>();
-  if (!_indexByName) return out;
-  for (const [name, vec] of _indexByName) {
-    out.set(name, cosine(qVec, vec));
-  }
-  return out;
-}
-
-export async function size(): Promise<number> {
-  const idx = await _loadIndex();
-  return idx?.chunks?.length ?? 0;
-}
-
-export type ChunkProviderInfo = {
-  provider: string | undefined;
-  model: string | undefined;
-  dims: number | undefined;
-};
-
-export async function providerInfo(): Promise<ChunkProviderInfo | null> {
-  const idx = await _loadIndex();
-  return idx ? { provider: idx.provider, model: idx.model, dims: idx.dims } : null;
-}

package/embedding/embedding-provider.ts

@@ -1,111 +0,0 @@
-/**
- * Pluggable embedding provider. Two implementations:
- *
- *   voyage() — Voyage AI, voyage-3-lite by default (1024 dims).
- *              Env: VOYAGE_API_KEY. Anthropic-recommended; generous free tier.
- *
- *   openai() — OpenAI text-embedding-3-small (1536 dims).
- *              Env: OPENAI_API_KEY. Cheap ($0.02/1M tokens).
- *
- * detectProvider() picks Voyage if available, else OpenAI, else null.
- * A null provider means "embeddings unavailable" — callers should fall back
- * to keyword retrieval cleanly.
- *
- * Both implementations batch inputs to minimize round-trips. Every provider
- * returns a Promise<Float32Array[]> of the same length as the input.
- */
-
-const VOYAGE_URL = 'https://api.voyageai.com/v1/embeddings';
-const OPENAI_URL = 'https://api.openai.com/v1/embeddings';
-
-// `process` is not in scope under "types": []
-declare const process: { env?: Record<string, string | undefined> } | undefined;
-
-function getEnv(key: string): string {
-  if (typeof process !== 'undefined' && process.env?.[key]) return process.env[key] as string;
-  try {
-    const env = (import.meta as { env?: Record<string, string | undefined> }).env;
-    if (env?.[`VITE_${key}`]) return env[`VITE_${key}`] as string;
-    if (env?.[key]) return env[key] as string;
-  } catch {}
-  return '';
-}
-
-export type EmbedFn = (texts: string[]) => Promise<Float32Array[]>;
-
-export type ProviderInfo = {
-  name: string;
-  model: string;
-  embed: EmbedFn;
-};
-
-/**
- * Voyage AI embedding provider.
- * Returns an embed function, or null if no key.
- */
-export function voyage({ apiKey, model = 'voyage-3-lite' }: { apiKey?: string; model?: string } = {}): EmbedFn | null {
-  const key = apiKey ?? getEnv('VOYAGE_API_KEY');
-  if (!key) return null;
-
-  return async function embed(texts: string[]): Promise<Float32Array[]> {
-    if (!Array.isArray(texts) || texts.length === 0) return [];
-    const res = await fetch(VOYAGE_URL, {
-      method: 'POST',
-      headers: {
-        'content-type': 'application/json',
-        'authorization': `Bearer ${key}`,
-      },
-      body: JSON.stringify({ input: texts, model, input_type: 'document' }),
-    });
-    if (!res.ok) throw new Error(`Voyage ${res.status}: ${(await res.text()).slice(0, 200)}`);
-    const data = await res.json() as { data: Array<{ embedding: number[] }> };
-    return data.data.map(d => new Float32Array(d.embedding));
-  };
-}
-
-/**
- * OpenAI text-embedding-3-small provider.
- * Returns an embed function, or null if no key.
- */
-export function openai({ apiKey, model = 'text-embedding-3-small' }: { apiKey?: string; model?: string } = {}): EmbedFn | null {
-  const key = apiKey ?? getEnv('OPENAI_API_KEY');
-  if (!key) return null;
-
-  return async function embed(texts: string[]): Promise<Float32Array[]> {
-    if (!Array.isArray(texts) || texts.length === 0) return [];
-    const res = await fetch(OPENAI_URL, {
-      method: 'POST',
-      headers: {
-        'content-type': 'application/json',
-        'authorization': `Bearer ${key}`,
-      },
-      body: JSON.stringify({ input: texts, model }),
-    });
-    if (!res.ok) throw new Error(`OpenAI ${res.status}: ${(await res.text()).slice(0, 200)}`);
-    const data = await res.json() as { data: Array<{ embedding: number[] }> };
-    return data.data.map(d => new Float32Array(d.embedding));
-  };
-}
-
-/**
- * Auto-detect the best available provider. Voyage first (cheaper, dense vectors
- * at 1024 dims), then OpenAI, then null.
- */
-export function detectProvider(): ProviderInfo | null {
-  const v = voyage(); if (v) return { name: 'voyage',  model: 'voyage-3-lite',             embed: v };
-  const o = openai(); if (o) return { name: 'openai',  model: 'text-embedding-3-small',    embed: o };
-  return null;
-}
-
-/** Cosine similarity between two Float32Arrays of the same length. */
-export function cosine(a: Float32Array, b: Float32Array): number {
-  if (!a || !b || a.length !== b.length) return 0;
-  let dot = 0, na = 0, nb = 0;
-  for (let i = 0; i < a.length; i++) {
-    dot += (a[i] ?? 0) * (b[i] ?? 0);
-    na  += (a[i] ?? 0) * (a[i] ?? 0);
-    nb  += (b[i] ?? 0) * (b[i] ?? 0);
-  }
-  if (na === 0 || nb === 0) return 0;
-  return dot / (Math.sqrt(na) * Math.sqrt(nb));
-}

package/embedding/index.ts

@@ -1,10 +0,0 @@
-/**
- * @adia-ai/a2ui-retrieval/embedding — embedding-provider + chunk retriever surface.
- *
- * Since §65 (v0.4.7), the legacy pattern-embedding retriever was retired
- * along with its only consumer (concept-mapper.js, dead post-§64). The
- * canonical retrieval surface post-§40 is chunk-embedding-retriever.
- */
-
-export * from './embedding-provider.js';
-export * from './chunk-embedding-retriever.js';