frontend-agent 1.0.0

package/dist/rag.js

@@ -0,0 +1,132 @@
+import MiniSearch from 'minisearch';
+import { stemmer } from 'stemmer';
+
+// src/rag/localRetriever.ts
+var LocalMiniSearchRAG = class _LocalMiniSearchRAG {
+  cat;
+  know;
+  catById;
+  knowById;
+  constructor(index) {
+    const processTerm = (t) => stemmer(t.toLowerCase());
+    const searchOptions = { fuzzy: 0.2, prefix: true, boost: { title: 2 } };
+    this.cat = new MiniSearch({
+      idField: "id",
+      fields: ["title", "group", "summary"],
+      processTerm,
+      searchOptions
+    });
+    this.cat.addAll(index.catalog);
+    this.know = new MiniSearch({
+      idField: "id",
+      fields: ["title", "text"],
+      processTerm,
+      searchOptions
+    });
+    this.know.addAll(index.knowledge);
+    this.catById = new Map(index.catalog.map((c) => [c.id, c]));
+    this.knowById = new Map(index.knowledge.map((d) => [d.id, d]));
+  }
+  static async fromUrl(url) {
+    const res = await fetch(url);
+    if (!res.ok) throw new Error(`failed to load RAG index: ${res.status} ${url}`);
+    return new _LocalMiniSearchRAG(await res.json());
+  }
+  hint(n = 6) {
+    const groups = /* @__PURE__ */ new Map();
+    for (const c of this.catById.values()) {
+      const g = c.group ?? "";
+      const bucket = groups.get(g);
+      if (bucket) bucket.push(c);
+      else groups.set(g, [c]);
+    }
+    const buckets = [...groups.values()];
+    const picked = [];
+    const max = Math.max(0, ...buckets.map((b) => b.length));
+    for (let i = 0; i < max && picked.length < n; i++) {
+      for (const b of buckets) {
+        if (b[i]) picked.push(b[i]);
+        if (picked.length >= n) break;
+      }
+    }
+    return picked.map((c) => `${c.title} [${c.id}]`).join("; ");
+  }
+  getItem(id) {
+    const it = this.catById.get(id);
+    return it ? { id: it.id, title: it.title, price: it.price, in_stock: it.in_stock } : null;
+  }
+  async searchCatalog(query, opts = {}) {
+    const k = opts.k ?? 5;
+    const out = [];
+    for (const hit of this.cat.search(query)) {
+      const item = this.catById.get(hit.id);
+      if (!item) continue;
+      if (opts.maxPrice != null && (item.price == null || item.price > opts.maxPrice)) continue;
+      out.push({
+        id: item.id,
+        title: item.title,
+        snippet: snippet(item.summary, 120),
+        price: item.price,
+        in_stock: item.in_stock,
+        attrs: {},
+        score: round(hit.score)
+      });
+      if (out.length >= k) break;
+    }
+    return out;
+  }
+  async searchKnowledge(query, k = 4) {
+    const out = [];
+    for (const hit of this.know.search(query)) {
+      const item = this.knowById.get(hit.id);
+      if (!item) continue;
+      out.push({ id: item.id, title: item.title, snippet: snippet(item.text, 480), score: round(hit.score) });
+      if (out.length >= k) break;
+    }
+    return out;
+  }
+};
+var snippet = (t, cap) => t.trim().slice(0, cap).trimEnd();
+var round = (n) => Math.round(n * 1e3) / 1e3;
+
+// src/rag/ragClient.ts
+function createRagClient(endpoint, init) {
+  async function remote(index, query, filters, topK) {
+    const res = await fetch(endpoint, {
+      method: "POST",
+      headers: { "content-type": "application/json", ...init?.headers ?? {} },
+      body: JSON.stringify({ index, query, filters, top_k: topK }),
+      ...init
+    });
+    if (!res.ok) throw new Error(`rag endpoint ${res.status}`);
+    const json = await res.json();
+    return json.results ?? [];
+  }
+  return {
+    async searchCatalog(query, opts = {}) {
+      const k = opts.k ?? 5;
+      const filters = opts.maxPrice != null ? { max_price: opts.maxPrice } : {};
+      return (await remote("catalog", query, filters, k)).map((r) => ({
+        id: r.id,
+        title: r.title,
+        snippet: r.snippet ?? r.text ?? "",
+        price: r.price ?? r.meta?.price ?? null,
+        in_stock: r.in_stock ?? r.meta?.in_stock ?? true,
+        attrs: r.attrs ?? r.meta ?? {},
+        score: r.score ?? 0
+      }));
+    },
+    async searchKnowledge(query, k = 4) {
+      return (await remote("knowledge", query, {}, k)).map((r) => ({
+        id: r.id,
+        title: r.title,
+        snippet: r.snippet ?? r.text ?? "",
+        score: r.score ?? 0
+      }));
+    }
+  };
+}
+
+export { LocalMiniSearchRAG, createRagClient };
+//# sourceMappingURL=rag.js.map
+//# sourceMappingURL=rag.js.map

package/dist/rag.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/rag/localRetriever.ts","../src/rag/ragClient.ts"],"names":[],"mappings":";;;;AAkBO,IAAM,kBAAA,GAAN,MAAM,mBAAA,CAAyC;AAAA,EACnC,GAAA;AAAA,EACA,IAAA;AAAA,EACA,OAAA;AAAA,EACA,QAAA;AAAA,EAEjB,YAAY,KAAA,EAAiB;AAC3B,IAAA,MAAM,cAAc,CAAC,CAAA,KAAc,OAAA,CAAQ,CAAA,CAAE,aAAa,CAAA;AAC1D,IAAA,MAAM,aAAA,GAAgB,EAAE,KAAA,EAAO,GAAA,EAAK,MAAA,EAAQ,MAAM,KAAA,EAAO,EAAE,KAAA,EAAO,CAAA,EAAE,EAAE;AACtE,IAAA,IAAA,CAAK,GAAA,GAAM,IAAI,UAAA,CAAwB;AAAA,MACrC,OAAA,EAAS,IAAA;AAAA,MACT,MAAA,EAAQ,CAAC,OAAA,EAAS,OAAA,EAAS,SAAS,CAAA;AAAA,MACpC,WAAA;AAAA,MACA;AAAA,KACD,CAAA;AACD,IAAA,IAAA,CAAK,GAAA,CAAI,MAAA,CAAO,KAAA,CAAM,OAAO,CAAA;AAC7B,IAAA,IAAA,CAAK,IAAA,GAAO,IAAI,UAAA,CAA0B;AAAA,MACxC,OAAA,EAAS,IAAA;AAAA,MACT,MAAA,EAAQ,CAAC,OAAA,EAAS,MAAM,CAAA;AAAA,MACxB,WAAA;AAAA,MACA;AAAA,KACD,CAAA;AACD,IAAA,IAAA,CAAK,IAAA,CAAK,MAAA,CAAO,KAAA,CAAM,SAAS,CAAA;AAChC,IAAA,IAAA,CAAK,OAAA,GAAU,IAAI,GAAA,CAAI,KAAA,CAAM,OAAA,CAAQ,GAAA,CAAI,CAAC,CAAA,KAAM,CAAC,CAAA,CAAE,EAAA,EAAI,CAAC,CAAC,CAAC,CAAA;AAC1D,IAAA,IAAA,CAAK,QAAA,GAAW,IAAI,GAAA,CAAI,KAAA,CAAM,SAAA,CAAU,GAAA,CAAI,CAAC,CAAA,KAAM,CAAC,CAAA,CAAE,EAAA,EAAI,CAAC,CAAC,CAAC,CAAA;AAAA,EAC/D;AAAA,EAEA,aAAa,QAAQ,GAAA,EAA0C;AAC7D,IAAA,MAAM,GAAA,GAAM,MAAM,KAAA,CAAM,GAAG,CAAA;AAC3B,IAAA,IAAI,CAAC,GAAA,CAAI,EAAA,EAAI,MAAM,IAAI,KAAA,CAAM,CAAA,0BAAA,EAA6B,GAAA,CAAI,MAAM,CAAA,CAAA,EAAI,GAAG,CAAA,CAAE,CAAA;AAC7E,IAAA,OAAO,IAAI,mBAAA,CAAoB,MAAM,GAAA,CAAI,MAAmB,CAAA;AAAA,EAC9D;AAAA,EAEA,IAAA,CAAK,IAAI,CAAA,EAAW;AAGlB,IAAA,MAAM,MAAA,uBAAa,GAAA,EAA2B;AAC9C,IAAA,KAAA,MAAW,CAAA,IAAK,IAAA,CAAK,OAAA,CAAQ,MAAA,EAAO,EAAG;AACrC,MAAA,MAAM,CAAA,GAAI,EAAE,KAAA,IAAS,EAAA;AACrB,MAAA,MAAM,MAAA,GAAS,MAAA,CAAO,GAAA,CAAI,CAAC,CAAA;AAC3B,MAAA,IAAI,MAAA,EAAQ,MAAA,CAAO,IAAA,CAAK,CAAC,CAAA;AAAA,WACpB,MAAA,CAAO,GAAA,CAAI,CAAA,EAAG,CAAC,CAAC,CAAC,CAAA;AAAA,IACxB;AACA,IAAA,MAAM,OAAA,GAAU,CAAC,GAAG,MAAA,CAAO,QAAQ,CAAA;AACnC,IAAA,MAAM,SAAwB,EAAC;AAC/B,IAAA,MAAM,GAAA,GAAM,IAAA,CAAK,GAAA,CAAI,CAAA,EAAG,GAAG,OAAA,CAAQ,GAAA,CAAI,CAAC,CAAA,KAAM,CAAA,CAAE,MAAM,CAAC,CAAA;AACvD,IAAA,KAAA,IAAS,IAAI,CAAA,EAAG,CAAA,GAAI,OAAO,MAAA,CAAO,MAAA,GAAS,GAAG,CAAA,EAAA,EAAK;AACjD,MAAA,KAAA,MAAW,KAAK,OAAA,EAAS;AACvB,QAAA,IAAI,EAAE,CAAC,CAAA,SAAU,IAAA,CAAK,CAAA,CAAE,CAAC,CAAC,CAAA;AAC1B,QAAA,IAAI,MAAA,CAAO,UAAU,CAAA,EAAG;AAAA,MAC1B;AAAA,IACF;AACA,IAAA,OAAO,MAAA,CAAO,GAAA,CAAI,CAAC,CAAA,KAAM,CAAA,EAAG,CAAA,CAAE,KAAK,CAAA,EAAA,EAAK,CAAA,CAAE,EAAE,CAAA,CAAA,CAAG,CAAA,CAAE,KAAK,IAAI,CAAA;AAAA,EAC5D;AAAA,EAEA,QAAQ,EAAA,EAAoC;AAC1C,IAAA,MAAM,EAAA,GAAK,IAAA,CAAK,OAAA,CAAQ,GAAA,CAAI,EAAE,CAAA;AAC9B,IAAA,OAAO,EAAA,GAAK,EAAE,EAAA,EAAI,EAAA,CAAG,IAAI,KAAA,EAAO,EAAA,CAAG,KAAA,EAAO,KAAA,EAAO,EAAA,CAAG,KAAA,EAAO,QAAA,EAAU,EAAA,CAAG,UAAS,GAAI,IAAA;AAAA,EACvF;AAAA,EAEA,MAAM,aAAA,CACJ,KAAA,EACA,IAAA,GAA0C,EAAC,EACjB;AAC1B,IAAA,MAAM,CAAA,GAAI,KAAK,CAAA,IAAK,CAAA;AACpB,IAAA,MAAM,MAAuB,EAAC;AAC9B,IAAA,KAAA,MAAW,GAAA,IAAO,IAAA,CAAK,GAAA,CAAI,MAAA,CAAO,KAAK,CAAA,EAAG;AACxC,MAAA,MAAM,IAAA,GAAO,IAAA,CAAK,OAAA,CAAQ,GAAA,CAAI,IAAI,EAAY,CAAA;AAC9C,MAAA,IAAI,CAAC,IAAA,EAAM;AACX,MAAA,IAAI,IAAA,CAAK,YAAY,IAAA,KAAS,IAAA,CAAK,SAAS,IAAA,IAAQ,IAAA,CAAK,KAAA,GAAQ,IAAA,CAAK,QAAA,CAAA,EAAW;AACjF,MAAA,GAAA,CAAI,IAAA,CAAK;AAAA,QACP,IAAI,IAAA,CAAK,EAAA;AAAA,QACT,OAAO,IAAA,CAAK,KAAA;AAAA,QACZ,OAAA,EAAS,OAAA,CAAQ,IAAA,CAAK,OAAA,EAAS,GAAG,CAAA;AAAA,QAClC,OAAO,IAAA,CAAK,KAAA;AAAA,QACZ,UAAU,IAAA,CAAK,QAAA;AAAA,QACf,OAAO,EAAC;AAAA,QACR,KAAA,EAAO,KAAA,CAAM,GAAA,CAAI,KAAK;AAAA,OACvB,CAAA;AACD,MAAA,IAAI,GAAA,CAAI,UAAU,CAAA,EAAG;AAAA,IACvB;AACA,IAAA,OAAO,GAAA;AAAA,EACT;AAAA,EAEA,MAAM,eAAA,CAAgB,KAAA,EAAe,CAAA,GAAI,CAAA,EAA+B;AACtE,IAAA,MAAM,MAAyB,EAAC;AAChC,IAAA,KAAA,MAAW,GAAA,IAAO,IAAA,CAAK,IAAA,CAAK,MAAA,CAAO,KAAK,CAAA,EAAG;AACzC,MAAA,MAAM,IAAA,GAAO,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,IAAI,EAAY,CAAA;AAC/C,MAAA,IAAI,CAAC,IAAA,EAAM;AAEX,MAAA,GAAA,CAAI,KAAK,EAAE,EAAA,EAAI,KAAK,EAAA,EAAI,KAAA,EAAO,KAAK,KAAA,EAAO,OAAA,EAAS,QAAQ,IAAA,CAAK,IAAA,EAAM,GAAG,CAAA,EAAG,KAAA,EAAO,MAAM,GAAA,CAAI,KAAK,GAAG,CAAA;AACtG,MAAA,IAAI,GAAA,CAAI,UAAU,CAAA,EAAG;AAAA,IACvB;AACA,IAAA,OAAO,GAAA;AAAA,EACT;AACF;AAEA,IAAM,OAAA,GAAU,CAAC,CAAA,EAAW,GAAA,KAAwB,CAAA,CAAE,IAAA,EAAK,CAAE,KAAA,CAAM,CAAA,EAAG,GAAG,CAAA,CAAE,OAAA,EAAQ;AACnF,IAAM,QAAQ,CAAC,CAAA,KAAsB,KAAK,KAAA,CAAM,CAAA,GAAI,GAAI,CAAA,GAAI,GAAA;;;ACzGrD,SAAS,eAAA,CAAgB,UAAkB,IAAA,EAAgC;AAChF,EAAA,eAAe,MAAA,CACb,KAAA,EACA,KAAA,EACA,OAAA,EACA,IAAA,EACsB;AACtB,IAAA,MAAM,GAAA,GAAM,MAAM,KAAA,CAAM,QAAA,EAAU;AAAA,MAChC,MAAA,EAAQ,MAAA;AAAA,MACR,OAAA,EAAS,EAAE,cAAA,EAAgB,kBAAA,EAAoB,GAAI,IAAA,EAAM,OAAA,IAAW,EAAC,EAAG;AAAA,MACxE,IAAA,EAAM,KAAK,SAAA,CAAU,EAAE,OAAO,KAAA,EAAO,OAAA,EAAS,KAAA,EAAO,IAAA,EAAM,CAAA;AAAA,MAC3D,GAAG;AAAA,KACJ,CAAA;AACD,IAAA,IAAI,CAAC,IAAI,EAAA,EAAI,MAAM,IAAI,KAAA,CAAM,CAAA,aAAA,EAAgB,GAAA,CAAI,MAAM,CAAA,CAAE,CAAA;AACzD,IAAA,MAAM,IAAA,GAAQ,MAAM,GAAA,CAAI,IAAA,EAAK;AAC7B,IAAA,OAAO,IAAA,CAAK,WAAW,EAAC;AAAA,EAC1B;AAEA,EAAA,OAAO;AAAA,IACL,MAAM,aAAA,CAAc,KAAA,EAAO,IAAA,GAAO,EAAC,EAA6B;AAC9D,MAAA,MAAM,CAAA,GAAI,KAAK,CAAA,IAAK,CAAA;AACpB,MAAA,MAAM,OAAA,GAAU,KAAK,QAAA,IAAY,IAAA,GAAO,EAAE,SAAA,EAAW,IAAA,CAAK,QAAA,EAAS,GAAI,EAAC;AACxE,MAAA,OAAA,CAAQ,MAAM,OAAO,SAAA,EAAW,KAAA,EAAO,SAAS,CAAC,CAAA,EAAG,GAAA,CAAI,CAAC,CAAA,MAAO;AAAA,QAC9D,IAAI,CAAA,CAAE,EAAA;AAAA,QACN,OAAO,CAAA,CAAE,KAAA;AAAA,QACT,OAAA,EAAS,CAAA,CAAE,OAAA,IAAW,CAAA,CAAE,IAAA,IAAQ,EAAA;AAAA,QAChC,KAAA,EAAO,CAAA,CAAE,KAAA,IAAS,CAAA,CAAE,MAAM,KAAA,IAAS,IAAA;AAAA,QACnC,QAAA,EAAU,CAAA,CAAE,QAAA,IAAY,CAAA,CAAE,MAAM,QAAA,IAAY,IAAA;AAAA,QAC5C,KAAA,EAAO,CAAA,CAAE,KAAA,IAAS,CAAA,CAAE,QAAQ,EAAC;AAAA,QAC7B,KAAA,EAAO,EAAE,KAAA,IAAS;AAAA,OACpB,CAAE,CAAA;AAAA,IACJ,CAAA;AAAA,IACA,MAAM,eAAA,CAAgB,KAAA,EAAO,CAAA,GAAI,CAAA,EAA+B;AAC9D,MAAA,OAAA,CAAQ,MAAM,MAAA,CAAO,WAAA,EAAa,KAAA,EAAO,IAAI,CAAC,CAAA,EAAG,GAAA,CAAI,CAAC,CAAA,MAAO;AAAA,QAC3D,IAAI,CAAA,CAAE,EAAA;AAAA,QACN,OAAO,CAAA,CAAE,KAAA;AAAA,QACT,OAAA,EAAS,CAAA,CAAE,OAAA,IAAW,CAAA,CAAE,IAAA,IAAQ,EAAA;AAAA,QAChC,KAAA,EAAO,EAAE,KAAA,IAAS;AAAA,OACpB,CAAE,CAAA;AAAA,IACJ;AAAA,GACF;AACF","file":"rag.js","sourcesContent":["import MiniSearch from 'minisearch'\nimport { stemmer } from 'stemmer'\nimport type {\n  CatalogItem,\n  CatalogItemLite,\n  CatalogResult,\n  KnowledgeItem,\n  KnowledgeResult,\n  RagBackend,\n  RagIndex,\n} from './types'\n\n/**\n * Zero-infra in-browser retrieval: MiniSearch (BM25 + fuzzy + prefix) with a Porter stemmer over an\n * index you supply. The algorithm need NOT match the training retriever - the model grounds in\n * whatever RESULTS come back; only the result shape is the contract. Construct with an index object,\n * or `LocalMiniSearchRAG.fromUrl(url)` to fetch one.\n */\nexport class LocalMiniSearchRAG implements RagBackend {\n  private readonly cat: MiniSearch<CatalogItem>\n  private readonly know: MiniSearch<KnowledgeItem>\n  private readonly catById: Map<string, CatalogItem>\n  private readonly knowById: Map<string, KnowledgeItem>\n\n  constructor(index: RagIndex) {\n    const processTerm = (t: string) => stemmer(t.toLowerCase())\n    const searchOptions = { fuzzy: 0.2, prefix: true, boost: { title: 2 } }\n    this.cat = new MiniSearch<CatalogItem>({\n      idField: 'id',\n      fields: ['title', 'group', 'summary'],\n      processTerm,\n      searchOptions,\n    })\n    this.cat.addAll(index.catalog)\n    this.know = new MiniSearch<KnowledgeItem>({\n      idField: 'id',\n      fields: ['title', 'text'],\n      processTerm,\n      searchOptions,\n    })\n    this.know.addAll(index.knowledge)\n    this.catById = new Map(index.catalog.map((c) => [c.id, c]))\n    this.knowById = new Map(index.knowledge.map((d) => [d.id, d]))\n  }\n\n  static async fromUrl(url: string): Promise<LocalMiniSearchRAG> {\n    const res = await fetch(url)\n    if (!res.ok) throw new Error(`failed to load RAG index: ${res.status} ${url}`)\n    return new LocalMiniSearchRAG((await res.json()) as RagIndex)\n  }\n\n  hint(n = 6): string {\n    // Representative sample ACROSS groups - not the first n (which may all be one category, leaving\n    // the model unaware the store even sells other categories). Round-robin: one per group, repeat.\n    const groups = new Map<string, CatalogItem[]>()\n    for (const c of this.catById.values()) {\n      const g = c.group ?? ''\n      const bucket = groups.get(g)\n      if (bucket) bucket.push(c)\n      else groups.set(g, [c])\n    }\n    const buckets = [...groups.values()]\n    const picked: CatalogItem[] = []\n    const max = Math.max(0, ...buckets.map((b) => b.length))\n    for (let i = 0; i < max && picked.length < n; i++) {\n      for (const b of buckets) {\n        if (b[i]) picked.push(b[i])\n        if (picked.length >= n) break\n      }\n    }\n    return picked.map((c) => `${c.title} [${c.id}]`).join('; ')\n  }\n\n  getItem(id: string): CatalogItemLite | null {\n    const it = this.catById.get(id)\n    return it ? { id: it.id, title: it.title, price: it.price, in_stock: it.in_stock } : null\n  }\n\n  async searchCatalog(\n    query: string,\n    opts: { maxPrice?: number; k?: number } = {},\n  ): Promise<CatalogResult[]> {\n    const k = opts.k ?? 5\n    const out: CatalogResult[] = []\n    for (const hit of this.cat.search(query)) {\n      const item = this.catById.get(hit.id as string)\n      if (!item) continue\n      if (opts.maxPrice != null && (item.price == null || item.price > opts.maxPrice)) continue\n      out.push({\n        id: item.id,\n        title: item.title,\n        snippet: snippet(item.summary, 120),\n        price: item.price,\n        in_stock: item.in_stock,\n        attrs: {},\n        score: round(hit.score),\n      })\n      if (out.length >= k) break\n    }\n    return out\n  }\n\n  async searchKnowledge(query: string, k = 4): Promise<KnowledgeResult[]> {\n    const out: KnowledgeResult[] = []\n    for (const hit of this.know.search(query)) {\n      const item = this.knowById.get(hit.id as string)\n      if (!item) continue\n      // long knowledge snippets (480) so how-to/procedural answers are fully present in the passage\n      out.push({ id: item.id, title: item.title, snippet: snippet(item.text, 480), score: round(hit.score) })\n      if (out.length >= k) break\n    }\n    return out\n  }\n}\n\nconst snippet = (t: string, cap: number): string => t.trim().slice(0, cap).trimEnd()\nconst round = (n: number): number => Math.round(n * 1000) / 1000\n","import type { CatalogResult, KnowledgeResult, RagBackend } from './types'\n\n/**\n * Bring-your-own retrieval backend. Speaks a single contract to your search service, then normalizes\n * to the frozen model-facing shape - so the model can't tell which backend answered:\n *\n *   POST {endpoint}  { index: \"catalog\"|\"knowledge\", query, filters, top_k }\n *                 -> { results: [{ id, title, text, score, meta }] }\n *\n * Point `endpoint` at your Qdrant/pgvector/Elastic/Typesense adapter.\n */\nexport function createRagClient(endpoint: string, init?: RequestInit): RagBackend {\n  async function remote(\n    index: 'catalog' | 'knowledge',\n    query: string,\n    filters: Record<string, unknown>,\n    topK: number,\n  ): Promise<RemoteRow[]> {\n    const res = await fetch(endpoint, {\n      method: 'POST',\n      headers: { 'content-type': 'application/json', ...(init?.headers ?? {}) },\n      body: JSON.stringify({ index, query, filters, top_k: topK }),\n      ...init,\n    })\n    if (!res.ok) throw new Error(`rag endpoint ${res.status}`)\n    const json = (await res.json()) as { results?: RemoteRow[] }\n    return json.results ?? []\n  }\n\n  return {\n    async searchCatalog(query, opts = {}): Promise<CatalogResult[]> {\n      const k = opts.k ?? 5\n      const filters = opts.maxPrice != null ? { max_price: opts.maxPrice } : {}\n      return (await remote('catalog', query, filters, k)).map((r) => ({\n        id: r.id,\n        title: r.title,\n        snippet: r.snippet ?? r.text ?? '',\n        price: r.price ?? r.meta?.price ?? null,\n        in_stock: r.in_stock ?? r.meta?.in_stock ?? true,\n        attrs: r.attrs ?? r.meta ?? {},\n        score: r.score ?? 0,\n      }))\n    },\n    async searchKnowledge(query, k = 4): Promise<KnowledgeResult[]> {\n      return (await remote('knowledge', query, {}, k)).map((r) => ({\n        id: r.id,\n        title: r.title,\n        snippet: r.snippet ?? r.text ?? '',\n        score: r.score ?? 0,\n      }))\n    },\n  }\n}\n\ninterface RemoteRow {\n  id: string\n  title: string\n  text?: string\n  snippet?: string\n  price?: number | null\n  in_stock?: boolean\n  attrs?: Record<string, unknown>\n  score?: number\n  meta?: Record<string, unknown> & { price?: number | null; in_stock?: boolean }\n}\n"]}

package/dist/reference.d.ts

@@ -0,0 +1,38 @@
+import { b as ToolDefinition } from './types-ChI5DrVS.js';
+import { R as RagBackend } from './types-BqZ6-bpz.js';
+
+/** Cart operations the reference cart tools drive. Implement over your own state (store, signal, ...). */
+interface CartHandlers {
+    add(item: {
+        id: string;
+        title: string;
+        price: number;
+    }, quantity: number): void | Promise<void>;
+    remove(id: string): void | Promise<void>;
+    view(): CartView | Promise<CartView>;
+    clear(): void | Promise<void>;
+}
+interface CartView {
+    cart: {
+        id: string;
+        title: string;
+        price: number;
+        quantity: number;
+    }[];
+    total: number;
+}
+/** Move the storefront to a page. `target` is one of checkout|cart|home|product; `id` for product. */
+type NavigateHandler = (target: string, id?: string) => void | Promise<void>;
+interface ReferenceToolsConfig {
+    rag: RagBackend;
+    cart: CartHandlers;
+    navigate: NavigateHandler;
+}
+/**
+ * The 7 canonical tools the v1.0.0 model was trained on, wired to your handlers. Schemas (names,
+ * descriptions, order) are byte-identical to training; results use the trained shapes. Retrieval is
+ * RAG-as-a-tool; cart acts by `id`; navigate is read-only by construction.
+ */
+declare function referenceTools(cfg: ReferenceToolsConfig): ToolDefinition[];
+
+export { type CartHandlers, type CartView, type NavigateHandler, type ReferenceToolsConfig, referenceTools };

package/dist/reference.js

@@ -0,0 +1,119 @@
+// src/reference/tools.ts
+function referenceTools(cfg) {
+  const { rag, cart, navigate } = cfg;
+  return [
+    {
+      schema: {
+        name: "search_catalog",
+        description: "Full-text search the product catalog. Returns matching items with their id, title, price, availability (in stock or not), and a short snippet. Use it for products, prices, and stock/availability.",
+        parameters: {
+          type: "object",
+          properties: { query: { type: "string" }, max_price: { type: "number" } },
+          required: ["query"]
+        }
+      },
+      async handler(args) {
+        const query = String(args.query ?? "");
+        const maxPrice = args.max_price != null ? Number(args.max_price) : void 0;
+        return { results: await rag.searchCatalog(query, { maxPrice }) };
+      }
+    },
+    {
+      schema: {
+        name: "search_knowledge",
+        description: "Full-text search the knowledge base: buying guides, how-to, care, and policies. Use it for how-to and policy questions - not for prices or stock (use the catalog for those).",
+        parameters: {
+          type: "object",
+          properties: { query: { type: "string" } },
+          required: ["query"]
+        }
+      },
+      async handler(args) {
+        return { results: await rag.searchKnowledge(String(args.query ?? "")) };
+      }
+    },
+    {
+      schema: {
+        name: "add_to_cart",
+        description: "Add a catalog item to the cart by its id.",
+        parameters: {
+          type: "object",
+          properties: { id: { type: "string" }, quantity: { type: "integer" } },
+          required: ["id"]
+        }
+      },
+      async handler(args) {
+        const id = String(args.id ?? "");
+        const quantity = Number(args.quantity ?? 1);
+        const item = rag.getItem ? await rag.getItem(id) : { id, title: id, price: 0, in_stock: true };
+        if (!item) return { error: "not_found", id };
+        if (!item.in_stock) return { error: "out_of_stock", id };
+        await cart.add({ id: item.id, title: item.title, price: item.price ?? 0 }, quantity);
+        return { ok: true, added: { id: item.id, title: item.title, quantity } };
+      }
+    },
+    {
+      schema: {
+        name: "remove_from_cart",
+        description: "Remove an item from the cart by its id.",
+        parameters: {
+          type: "object",
+          properties: { id: { type: "string" } },
+          required: ["id"]
+        }
+      },
+      async handler(args) {
+        const id = String(args.id ?? "");
+        await cart.remove(id);
+        return { ok: true, removed: id };
+      }
+    },
+    {
+      schema: {
+        name: "view_cart",
+        description: "Show the current cart contents.",
+        parameters: { type: "object", properties: {} }
+      },
+      async handler() {
+        return await cart.view();
+      }
+    },
+    {
+      schema: {
+        name: "clear_cart",
+        description: "Empty the cart.",
+        parameters: { type: "object", properties: {} }
+      },
+      async handler() {
+        await cart.clear();
+        return { ok: true, cleared: true };
+      }
+    },
+    {
+      schema: {
+        name: "navigate",
+        description: "Navigate the storefront to a page: the cart, checkout, home, or a specific product page (pass its id when target is 'product').",
+        parameters: {
+          type: "object",
+          properties: {
+            target: { type: "string", enum: ["checkout", "cart", "home", "product"] },
+            id: { type: "string" }
+          },
+          required: ["target"]
+        }
+      },
+      async handler(args) {
+        const target = String(args.target ?? "").toLowerCase();
+        if (!["checkout", "cart", "home", "product"].includes(target)) {
+          return { error: "unknown_target", target };
+        }
+        await navigate(target, args.id != null ? String(args.id) : void 0);
+        return { ok: true, navigated: target };
+      }
+    }
+  ];
+}
+
+export { referenceTools };
+//# sourceMappingURL=reference.js.map
+//# sourceMappingURL=reference.js.map

package/dist/reference.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/reference/tools.ts"],"names":[],"mappings":";AA6BO,SAAS,eAAe,GAAA,EAA6C;AAC1E,EAAA,MAAM,EAAE,GAAA,EAAK,IAAA,EAAM,QAAA,EAAS,GAAI,GAAA;AAChC,EAAA,OAAO;AAAA,IACL;AAAA,MACE,MAAA,EAAQ;AAAA,QACN,IAAA,EAAM,gBAAA;AAAA,QACN,WAAA,EACE,qMAAA;AAAA,QAGF,UAAA,EAAY;AAAA,UACV,IAAA,EAAM,QAAA;AAAA,UACN,UAAA,EAAY,EAAE,KAAA,EAAO,EAAE,IAAA,EAAM,QAAA,EAAS,EAAG,SAAA,EAAW,EAAE,IAAA,EAAM,QAAA,EAAS,EAAE;AAAA,UACvE,QAAA,EAAU,CAAC,OAAO;AAAA;AACpB,OACF;AAAA,MACA,MAAM,QAAQ,IAAA,EAAM;AAClB,QAAA,MAAM,KAAA,GAAQ,MAAA,CAAO,IAAA,CAAK,KAAA,IAAS,EAAE,CAAA;AACrC,QAAA,MAAM,WAAW,IAAA,CAAK,SAAA,IAAa,OAAO,MAAA,CAAO,IAAA,CAAK,SAAS,CAAA,GAAI,MAAA;AACnE,QAAA,OAAO,EAAE,SAAS,MAAM,GAAA,CAAI,cAAc,KAAA,EAAO,EAAE,QAAA,EAAU,CAAA,EAAE;AAAA,MACjE;AAAA,KACF;AAAA,IACA;AAAA,MACE,MAAA,EAAQ;AAAA,QACN,IAAA,EAAM,kBAAA;AAAA,QACN,WAAA,EACE,+KAAA;AAAA,QAEF,UAAA,EAAY;AAAA,UACV,IAAA,EAAM,QAAA;AAAA,UACN,YAAY,EAAE,KAAA,EAAO,EAAE,IAAA,EAAM,UAAS,EAAE;AAAA,UACxC,QAAA,EAAU,CAAC,OAAO;AAAA;AACpB,OACF;AAAA,MACA,MAAM,QAAQ,IAAA,EAAM;AAClB,QAAA,OAAO,EAAE,OAAA,EAAS,MAAM,GAAA,CAAI,eAAA,CAAgB,OAAO,IAAA,CAAK,KAAA,IAAS,EAAE,CAAC,CAAA,EAAE;AAAA,MACxE;AAAA,KACF;AAAA,IACA;AAAA,MACE,MAAA,EAAQ;AAAA,QACN,IAAA,EAAM,aAAA;AAAA,QACN,WAAA,EAAa,2CAAA;AAAA,QACb,UAAA,EAAY;AAAA,UACV,IAAA,EAAM,QAAA;AAAA,UACN,UAAA,EAAY,EAAE,EAAA,EAAI,EAAE,IAAA,EAAM,QAAA,EAAS,EAAG,QAAA,EAAU,EAAE,IAAA,EAAM,SAAA,EAAU,EAAE;AAAA,UACpE,QAAA,EAAU,CAAC,IAAI;AAAA;AACjB,OACF;AAAA,MACA,MAAM,QAAQ,IAAA,EAAM;AAClB,QAAA,MAAM,EAAA,GAAK,MAAA,CAAO,IAAA,CAAK,EAAA,IAAM,EAAE,CAAA;AAC/B,QAAA,MAAM,QAAA,GAAW,MAAA,CAAO,IAAA,CAAK,QAAA,IAAY,CAAC,CAAA;AAC1C,QAAA,MAAM,IAAA,GAAO,GAAA,CAAI,OAAA,GAAU,MAAM,IAAI,OAAA,CAAQ,EAAE,CAAA,GAAI,EAAE,IAAI,KAAA,EAAO,EAAA,EAAI,KAAA,EAAO,CAAA,EAAG,UAAU,IAAA,EAAK;AAC7F,QAAA,IAAI,CAAC,IAAA,EAAM,OAAO,EAAE,KAAA,EAAO,aAAa,EAAA,EAAG;AAC3C,QAAA,IAAI,CAAC,IAAA,CAAK,QAAA,SAAiB,EAAE,KAAA,EAAO,gBAAgB,EAAA,EAAG;AACvD,QAAA,MAAM,IAAA,CAAK,GAAA,CAAI,EAAE,EAAA,EAAI,KAAK,EAAA,EAAI,KAAA,EAAO,IAAA,CAAK,KAAA,EAAO,KAAA,EAAO,IAAA,CAAK,KAAA,IAAS,CAAA,IAAK,QAAQ,CAAA;AACnF,QAAA,OAAO,EAAE,EAAA,EAAI,IAAA,EAAM,KAAA,EAAO,EAAE,EAAA,EAAI,IAAA,CAAK,EAAA,EAAI,KAAA,EAAO,IAAA,CAAK,KAAA,EAAO,QAAA,EAAS,EAAE;AAAA,MACzE;AAAA,KACF;AAAA,IACA;AAAA,MACE,MAAA,EAAQ;AAAA,QACN,IAAA,EAAM,kBAAA;AAAA,QACN,WAAA,EAAa,yCAAA;AAAA,QACb,UAAA,EAAY;AAAA,UACV,IAAA,EAAM,QAAA;AAAA,UACN,YAAY,EAAE,EAAA,EAAI,EAAE,IAAA,EAAM,UAAS,EAAE;AAAA,UACrC,QAAA,EAAU,CAAC,IAAI;AAAA;AACjB,OACF;AAAA,MACA,MAAM,QAAQ,IAAA,EAAM;AAClB,QAAA,MAAM,EAAA,GAAK,MAAA,CAAO,IAAA,CAAK,EAAA,IAAM,EAAE,CAAA;AAC/B,QAAA,MAAM,IAAA,CAAK,OAAO,EAAE,CAAA;AACpB,QAAA,OAAO,EAAE,EAAA,EAAI,IAAA,EAAM,OAAA,EAAS,EAAA,EAAG;AAAA,MACjC;AAAA,KACF;AAAA,IACA;AAAA,MACE,MAAA,EAAQ;AAAA,QACN,IAAA,EAAM,WAAA;AAAA,QACN,WAAA,EAAa,iCAAA;AAAA,QACb,YAAY,EAAE,IAAA,EAAM,QAAA,EAAU,UAAA,EAAY,EAAC;AAAE,OAC/C;AAAA,MACA,MAAM,OAAA,GAAU;AACd,QAAA,OAAO,MAAM,KAAK,IAAA,EAAK;AAAA,MACzB;AAAA,KACF;AAAA,IACA;AAAA,MACE,MAAA,EAAQ;AAAA,QACN,IAAA,EAAM,YAAA;AAAA,QACN,WAAA,EAAa,iBAAA;AAAA,QACb,YAAY,EAAE,IAAA,EAAM,QAAA,EAAU,UAAA,EAAY,EAAC;AAAE,OAC/C;AAAA,MACA,MAAM,OAAA,GAAU;AACd,QAAA,MAAM,KAAK,KAAA,EAAM;AACjB,QAAA,OAAO,EAAE,EAAA,EAAI,IAAA,EAAM,OAAA,EAAS,IAAA,EAAK;AAAA,MACnC;AAAA,KACF;AAAA,IACA;AAAA,MACE,MAAA,EAAQ;AAAA,QACN,IAAA,EAAM,UAAA;AAAA,QACN,WAAA,EACE,iIAAA;AAAA,QAEF,UAAA,EAAY;AAAA,UACV,IAAA,EAAM,QAAA;AAAA,UACN,UAAA,EAAY;AAAA,YACV,MAAA,EAAQ,EAAE,IAAA,EAAM,QAAA,EAAU,IAAA,EAAM,CAAC,UAAA,EAAY,MAAA,EAAQ,MAAA,EAAQ,SAAS,CAAA,EAAE;AAAA,YACxE,EAAA,EAAI,EAAE,IAAA,EAAM,QAAA;AAAS,WACvB;AAAA,UACA,QAAA,EAAU,CAAC,QAAQ;AAAA;AACrB,OACF;AAAA,MACA,MAAM,QAAQ,IAAA,EAAM;AAClB,QAAA,MAAM,SAAS,MAAA,CAAO,IAAA,CAAK,MAAA,IAAU,EAAE,EAAE,WAAA,EAAY;AACrD,QAAA,IAAI,CAAC,CAAC,UAAA,EAAY,MAAA,EAAQ,QAAQ,SAAS,CAAA,CAAE,QAAA,CAAS,MAAM,CAAA,EAAG;AAC7D,UAAA,OAAO,EAAE,KAAA,EAAO,gBAAA,EAAkB,MAAA,EAAO;AAAA,QAC3C;AACA,QAAA,MAAM,QAAA,CAAS,QAAQ,IAAA,CAAK,EAAA,IAAM,OAAO,MAAA,CAAO,IAAA,CAAK,EAAE,CAAA,GAAI,MAAS,CAAA;AACpE,QAAA,OAAO,EAAE,EAAA,EAAI,IAAA,EAAM,SAAA,EAAW,MAAA,EAAO;AAAA,MACvC;AAAA;AACF,GACF;AACF","file":"reference.js","sourcesContent":["import type { ToolDefinition } from '../tools/types'\nimport type { RagBackend } from '../rag/types'\n\n/** Cart operations the reference cart tools drive. Implement over your own state (store, signal, ...). */\nexport interface CartHandlers {\n  add(item: { id: string; title: string; price: number }, quantity: number): void | Promise<void>\n  remove(id: string): void | Promise<void>\n  view(): CartView | Promise<CartView>\n  clear(): void | Promise<void>\n}\nexport interface CartView {\n  cart: { id: string; title: string; price: number; quantity: number }[]\n  total: number\n}\n\n/** Move the storefront to a page. `target` is one of checkout|cart|home|product; `id` for product. */\nexport type NavigateHandler = (target: string, id?: string) => void | Promise<void>\n\nexport interface ReferenceToolsConfig {\n  rag: RagBackend\n  cart: CartHandlers\n  navigate: NavigateHandler\n}\n\n/**\n * The 7 canonical tools the v1.0.0 model was trained on, wired to your handlers. Schemas (names,\n * descriptions, order) are byte-identical to training; results use the trained shapes. Retrieval is\n * RAG-as-a-tool; cart acts by `id`; navigate is read-only by construction.\n */\nexport function referenceTools(cfg: ReferenceToolsConfig): ToolDefinition[] {\n  const { rag, cart, navigate } = cfg\n  return [\n    {\n      schema: {\n        name: 'search_catalog',\n        description:\n          'Full-text search the product catalog. Returns matching items with their id, title, price, ' +\n          'availability (in stock or not), and a short snippet. Use it for products, prices, and ' +\n          'stock/availability.',\n        parameters: {\n          type: 'object',\n          properties: { query: { type: 'string' }, max_price: { type: 'number' } },\n          required: ['query'],\n        },\n      },\n      async handler(args) {\n        const query = String(args.query ?? '')\n        const maxPrice = args.max_price != null ? Number(args.max_price) : undefined\n        return { results: await rag.searchCatalog(query, { maxPrice }) }\n      },\n    },\n    {\n      schema: {\n        name: 'search_knowledge',\n        description:\n          'Full-text search the knowledge base: buying guides, how-to, care, and policies. Use it for ' +\n          'how-to and policy questions - not for prices or stock (use the catalog for those).',\n        parameters: {\n          type: 'object',\n          properties: { query: { type: 'string' } },\n          required: ['query'],\n        },\n      },\n      async handler(args) {\n        return { results: await rag.searchKnowledge(String(args.query ?? '')) }\n      },\n    },\n    {\n      schema: {\n        name: 'add_to_cart',\n        description: 'Add a catalog item to the cart by its id.',\n        parameters: {\n          type: 'object',\n          properties: { id: { type: 'string' }, quantity: { type: 'integer' } },\n          required: ['id'],\n        },\n      },\n      async handler(args) {\n        const id = String(args.id ?? '')\n        const quantity = Number(args.quantity ?? 1)\n        const item = rag.getItem ? await rag.getItem(id) : { id, title: id, price: 0, in_stock: true }\n        if (!item) return { error: 'not_found', id }\n        if (!item.in_stock) return { error: 'out_of_stock', id }\n        await cart.add({ id: item.id, title: item.title, price: item.price ?? 0 }, quantity)\n        return { ok: true, added: { id: item.id, title: item.title, quantity } }\n      },\n    },\n    {\n      schema: {\n        name: 'remove_from_cart',\n        description: 'Remove an item from the cart by its id.',\n        parameters: {\n          type: 'object',\n          properties: { id: { type: 'string' } },\n          required: ['id'],\n        },\n      },\n      async handler(args) {\n        const id = String(args.id ?? '')\n        await cart.remove(id)\n        return { ok: true, removed: id }\n      },\n    },\n    {\n      schema: {\n        name: 'view_cart',\n        description: 'Show the current cart contents.',\n        parameters: { type: 'object', properties: {} },\n      },\n      async handler() {\n        return await cart.view()\n      },\n    },\n    {\n      schema: {\n        name: 'clear_cart',\n        description: 'Empty the cart.',\n        parameters: { type: 'object', properties: {} },\n      },\n      async handler() {\n        await cart.clear()\n        return { ok: true, cleared: true }\n      },\n    },\n    {\n      schema: {\n        name: 'navigate',\n        description:\n          'Navigate the storefront to a page: the cart, checkout, home, or a specific product page ' +\n          \"(pass its id when target is 'product').\",\n        parameters: {\n          type: 'object',\n          properties: {\n            target: { type: 'string', enum: ['checkout', 'cart', 'home', 'product'] },\n            id: { type: 'string' },\n          },\n          required: ['target'],\n        },\n      },\n      async handler(args) {\n        const target = String(args.target ?? '').toLowerCase()\n        if (!['checkout', 'cart', 'home', 'product'].includes(target)) {\n          return { error: 'unknown_target', target }\n        }\n        await navigate(target, args.id != null ? String(args.id) : undefined)\n        return { ok: true, navigated: target }\n      },\n    },\n  ]\n}\n"]}

package/dist/types-BqZ6-bpz.d.ts

@@ -0,0 +1,59 @@
+/** Frozen model-facing result shapes (what the model was trained to read from `search_*` tools). */
+interface CatalogResult {
+    id: string;
+    title: string;
+    snippet: string;
+    price: number | null;
+    in_stock: boolean;
+    attrs: Record<string, unknown>;
+    score: number;
+}
+interface KnowledgeResult {
+    id: string;
+    title: string;
+    snippet: string;
+    score: number;
+}
+/** Minimal catalog item used to resolve a cart action (add_to_cart). */
+interface CatalogItemLite {
+    id: string;
+    title: string;
+    price: number | null;
+    in_stock: boolean;
+}
+/**
+ * A retrieval backend behind the `search_*` tools. The model is retriever-agnostic - any
+ * implementation works as long as it returns the frozen result shapes above.
+ */
+interface RagBackend {
+    searchCatalog(query: string, opts?: {
+        maxPrice?: number;
+        k?: number;
+    }): Promise<CatalogResult[]>;
+    searchKnowledge(query: string, k?: number): Promise<KnowledgeResult[]>;
+    /** A bounded `Title [id]; ...` hint for the system prompt (optional). */
+    hint?(n?: number): Promise<string> | string;
+    /** Resolve a catalog item by id, for cart actions (optional). */
+    getItem?(id: string): Promise<CatalogItemLite | null> | CatalogItemLite | null;
+}
+/** Raw index rows for the in-browser MiniSearch backend. */
+interface CatalogItem {
+    id: string;
+    title: string;
+    group?: string;
+    price: number | null;
+    in_stock: boolean;
+    summary: string;
+    text?: string;
+}
+interface KnowledgeItem {
+    id: string;
+    title: string;
+    text: string;
+}
+interface RagIndex {
+    catalog: CatalogItem[];
+    knowledge: KnowledgeItem[];
+}
+
+export type { CatalogItemLite as C, KnowledgeResult as K, RagBackend as R, RagIndex as a, CatalogResult as b, CatalogItem as c, KnowledgeItem as d };

package/dist/types-ChI5DrVS.d.ts

@@ -0,0 +1,16 @@
+interface ToolSchema {
+    name: string;
+    description: string;
+    parameters: {
+        type: 'object';
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+}
+type ToolHandler = (args: Record<string, unknown>) => Promise<unknown> | unknown;
+interface ToolDefinition {
+    schema: ToolSchema;
+    handler: ToolHandler;
+}
+
+export type { ToolSchema as T, ToolHandler as a, ToolDefinition as b };

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "frontend-agent",
+  "version": "1.0.0",
+  "description": "Drive the LFM2.5-230M frontend-agent model in the browser: tool-calling + RAG-grounded answering, fully typed. Loads the GGUF from Hugging Face via wllama.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lajosbencz/frontend-agent.git",
+    "directory": "packages/frontend-agent"
+  },
+  "homepage": "https://github.com/lajosbencz/frontend-agent",
+  "bugs": {
+    "url": "https://github.com/lajosbencz/frontend-agent/issues"
+  },
+  "author": "Lajos Bencz",
+  "keywords": [
+    "lfm2",
+    "llm",
+    "agent",
+    "tool-calling",
+    "rag",
+    "wllama",
+    "edge",
+    "on-device",
+    "browser"
+  ],
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./rag": {
+      "types": "./dist/rag.d.ts",
+      "import": "./dist/rag.js"
+    },
+    "./reference": {
+      "types": "./dist/reference.d.ts",
+      "import": "./dist/reference.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "peerDependencies": {
+    "@wllama/wllama": ">=3.5.0",
+    "minisearch": ">=7.0.0",
+    "stemmer": ">=2.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@wllama/wllama": { "optional": true },
+    "minisearch": { "optional": true },
+    "stemmer": { "optional": true }
+  },
+  "devDependencies": {
+    "@wllama/wllama": "^3.5.1",
+    "minisearch": "^7.2.0",
+    "stemmer": "^2.0.1",
+    "tsup": "^8.5.1",
+    "typescript": "^7.0.2",
+    "vitest": "^4.1.10"
+  }
+}