brainbank 0.3.1 → 0.5.0

package/README.md

@@ -8,7 +8,7 @@ BrainBank gives LLMs a long-term memory that persists between sessions.
 - **Pluggable indexers** — `.use()` only what you need (code, git, docs, or custom)
 - **Dynamic collections** — `brain.collection('errors')` for any structured data
 - **Hybrid search** — vector + BM25 fused with Reciprocal Rank Fusion
-- **Pluggable embeddings** — local WASM (free) or OpenAI (higher quality)
+- **Pluggable embeddings** — local WASM (free), OpenAI, or Perplexity (standard & contextualized)
 - **Multi-repo** — index multiple repositories into one shared database
 - **Portable** — single `.brainbank/brainbank.db` file
 - **Optional packages** — [`@brainbank/memory`](#memory) (fact extraction + entity graph), [`@brainbank/reranker`](#reranker) (Qwen3 cross-encoder), [`@brainbank/mcp`](#mcp-server) (MCP server)
@@ -73,6 +73,7 @@ Most AI memory solutions (mem0, Zep, LangMem) require cloud services, external d
 - [Benchmarks](#benchmarks)
   - [Search Quality: AST vs Sliding Window](#search-quality-ast-vs-sliding-window)
   - [Grammar Support](#grammar-support)
+  - [RAG Retrieval Quality](#rag-retrieval-quality) · [Full Results →](./BENCHMARKS.md)
 
 ---
 
@@ -291,7 +292,7 @@ decisions.prune({ olderThan: '30d' });  // remove older than 30 days
 brain.listCollectionNames();            // → ['decisions', ...]
 ```
 
-> 📂 See [examples/collections](examples/collections/) for a complete runnable demo with cross-collection linking and metadata.
+> 📂 See [examples/collection](examples/collection/) for a complete runnable demo with cross-collection linking and metadata.
 
 ### Watch Mode
 
@@ -595,8 +596,9 @@ brainbank kv search conversations "what did we decide about auth"
 
 | Example | Description | Run |
 |---------|-------------|-----|
-| [chatbot](examples/chatbot/) | CLI chatbot with streaming + persistent memory (context injection + function calling) | `OPENAI_API_KEY=sk-... npx tsx examples/chatbot/chatbot.ts` |
-| [collections](examples/collections/) | Collections, semantic search, tags, metadata linking | `npx tsx examples/collections/collections.ts` |
+| [rag](examples/rag/) | RAG chatbot — docs retrieval + generation | `OPENAI_API_KEY=sk-... PERPLEXITY_API_KEY=pplx-... npx tsx examples/rag/rag.ts --docs <path>` |
+| [memory](examples/memory/) | Memory chatbot — fact extraction + entity graph | `OPENAI_API_KEY=sk-... npx tsx examples/memory/memory.ts` |
+| [collection](examples/collection/) | Collections, semantic search, tags, metadata linking | `npx tsx examples/collection/collection.ts` |
 
 ---
 
@@ -628,7 +630,7 @@ Add to your MCP config (`~/.gemini/antigravity/mcp_config.json` or Claude Deskto
 
 The agent passes the `repo` parameter on each tool call based on the active workspace — no hardcoded paths needed.
 
-> Set `BRAINBANK_EMBEDDING` to `openai` for higher quality search (requires `OPENAI_API_KEY`). Omit to use the free local WASM embeddings.
+> Set `BRAINBANK_EMBEDDING` to `openai`, `perplexity`, or `perplexity-context` for higher quality search. Omit to use the free local WASM embeddings.
 
 > Optionally set `BRAINBANK_REPO` as a default fallback repo. If omitted, every tool call must include the `repo` parameter (recommended for multi-workspace setups).
 
@@ -642,7 +644,7 @@ The agent passes the `repo` parameter on each tool call based on the active work
 > 2. MCP server starts without `BRAINBANK_EMBEDDING` env var → defaults to local (384 dims)
 > 3. **Result:** BrainBank throws `Embedding dimension mismatch` on every search
 >
-> **Fix:** Always set `BRAINBANK_EMBEDDING` consistently in your MCP config, CLI, and API usage. If you indexed with OpenAI, your MCP config **must** include `"BRAINBANK_EMBEDDING": "openai"`. If you switch providers, run `brainbank reembed` to regenerate all vectors.
+> **Fix:** Always set `BRAINBANK_EMBEDDING` consistently in your MCP config, CLI, and API usage. If you indexed with OpenAI, your MCP config **must** include `"BRAINBANK_EMBEDDING": "openai"`. Same for `perplexity` or `perplexity-context`. If you switch providers, run `brainbank reembed` to regenerate all vectors.
 
 ### Available Tools
 
@@ -686,22 +688,67 @@ const brain = new BrainBank({
 |----------|--------|------|-------|------|
 | **Local (default)** | built-in | 384 | ⚡ 0ms | Free |
 | **OpenAI** | `OpenAIEmbedding` | 1536 | ~100ms | $0.02/1M tokens |
+| **Perplexity** | `PerplexityEmbedding` | 2560 (4b) / 1024 (0.6b) | ~100ms | $0.02/1M tokens |
+| **Perplexity Context** | `PerplexityContextEmbedding` | 2560 (4b) / 1024 (0.6b) | ~100ms | $0.06/1M tokens |
+
+#### OpenAI
 
 ```typescript
 import { OpenAIEmbedding } from 'brainbank';
 
-// Uses OPENAI_API_KEY env var by default
-new OpenAIEmbedding();
-
-// Custom options
+new OpenAIEmbedding();                        // uses OPENAI_API_KEY env var
 new OpenAIEmbedding({
   model: 'text-embedding-3-large',
-  dims: 512,                          // custom dims (text-embedding-3 only)
+  dims: 512,                                  // Matryoshka reduction
   apiKey: 'sk-...',
-  baseUrl: 'https://my-proxy.com/v1/embeddings',  // Azure, proxies
+  baseUrl: 'https://my-proxy.com/v1/embeddings',
+});
+```
+
+#### Perplexity (Standard)
+
+Best for independent texts, queries, and code chunks.
+
+```typescript
+import { PerplexityEmbedding } from 'brainbank';
+
+new PerplexityEmbedding();                    // uses PERPLEXITY_API_KEY env var
+new PerplexityEmbedding({
+  model: 'pplx-embed-v1-0.6b',               // smaller, faster (1024d)
+  dims: 512,                                  // Matryoshka reduction
+});
+```
+
+#### Perplexity (Contextualized)
+
+Chunks share document context → better retrieval for related code/docs.
+
+```typescript
+import { PerplexityContextEmbedding } from 'brainbank';
+
+new PerplexityContextEmbedding();             // uses PERPLEXITY_API_KEY env var
+new PerplexityContextEmbedding({
+  model: 'pplx-embed-context-v1-0.6b',       // smaller, faster (1024d)
+  dims: 512,                                  // Matryoshka reduction
 });
 ```
 
+#### Benchmarks
+
+Real benchmarks on a production NestJS backend (1052 code chunks + git history):
+
+| Provider | Dims | Index Time | Avg Search | Cost |
+|----------|------|------------|------------|------|
+| **Local WASM** | 384 | 87s | **8ms** | Free |
+| **OpenAI** | 1536 | 106s | 202ms | $0.02/1M tok |
+| **Perplexity** | 2560 | **66s** ⚡ | 168ms | $0.02/1M tok |
+| **Perplexity Context** | 2560 | 78s | 135ms | $0.06/1M tok |
+
+- **Fastest indexing:** Perplexity standard — 38% faster than OpenAI
+- **Fastest search (API):** Perplexity Context — 33% faster than OpenAI
+- **Fastest search (total):** Local WASM — no network latency
+- **Best context awareness:** Perplexity Context — finds semantically related chunks others miss
+
 > [!WARNING]
 > Switching embedding provider (e.g. local → OpenAI) changes the vector dimensions. BrainBank will **refuse to initialize** if the stored dimensions don't match the current provider. Use `initialize({ force: true })` and then `reembed()` to migrate, or switch back to the original provider.
 
@@ -778,6 +825,91 @@ const myReranker: Reranker = {
 
 Without a reranker, BrainBank uses pure RRF fusion — which is already production-quality for most use cases.
 
+### Notes
+
+The notes plugin gives your agent **persistent conversation memory** — store structured digests of past sessions and recall them via hybrid search.
+
+```typescript
+import { BrainBank } from 'brainbank';
+import { notes } from 'brainbank/notes';
+
+const brain = new BrainBank({ repoPath: '.' });
+brain.use(notes());
+await brain.initialize();
+
+const notesPlugin = brain.indexer('notes');
+
+// Store a conversation digest
+await notesPlugin.remember({
+  title: 'Refactored auth module',
+  summary: 'Extracted JWT validation into middleware, added refresh token rotation',
+  decisions: ['Use RS256 over HS256', 'Refresh tokens stored in httpOnly cookie'],
+  filesChanged: ['src/auth/jwt.ts', 'src/middleware/auth.ts'],
+  patterns: ['Always validate token expiry before DB lookup'],
+  openQuestions: ['Should we add rate limiting to the refresh endpoint?'],
+  tags: ['auth', 'security'],
+});
+
+// Recall relevant notes
+const relevant = await notesPlugin.recall('JWT token validation', { k: 3 });
+
+// List recent notes
+const recent = notesPlugin.list(10);
+const longTermOnly = notesPlugin.list(10, 'long');
+
+// Consolidate: promote old short-term notes to long-term (keeps last 20 as short)
+const { promoted } = notesPlugin.consolidate(20);
+```
+
+**Memory tiers:**
+- **`short`** (default) — Full digest with all fields, kept for recent sessions
+- **`long`** — Compressed: only title, summary, decisions, and patterns preserved. Files and open questions dropped
+
+Consolidation automatically promotes notes beyond the keep window from `short` → `long`, reducing storage while preserving key learnings.
+
+### Agent Memory (Patterns)
+
+The memory plugin enables **learning from experience** — your agent records what worked (and what didn't) across tasks, then distills patterns into reusable strategies.
+
+```typescript
+import { BrainBank } from 'brainbank';
+import { memory } from 'brainbank/memory';
+
+const brain = new BrainBank({ repoPath: '.' });
+brain.use(memory());
+await brain.initialize();
+
+const mem = brain.indexer('memory');
+
+// Record a learning pattern
+await mem.learn({
+  taskType: 'refactor',
+  task: 'Extract auth logic into middleware',
+  approach: 'Created Express middleware, moved JWT validation from routes',
+  outcome: 'Reduced route handler size by 60%, improved testability',
+  successRate: 0.95,
+  critique: 'Should have added integration tests before refactoring',
+});
+
+// Search for similar patterns before starting a new task
+const patterns = await mem.search('refactor database queries');
+
+// Consolidate: prune old failures + merge duplicates
+const { pruned, deduped } = mem.consolidate();
+
+// Distill top patterns into a strategy
+const strategy = mem.distill('refactor');
+// → "Strategy for 'refactor' (5 patterns, avg success 88%):
+//    • Created middleware, moved validation from routes (95%)
+//      └ Should have added integration tests before refactoring"
+```
+
+**How it works:**
+1. **Learn** — Records task, approach, outcome, and success rate. Embeds for semantic search
+2. **Search** — Finds similar successful patterns (filters by `successRate ≥ 0.5`)
+3. **Consolidate** — Auto-runs every 50 patterns: prunes failures older than 90 days, deduplicates (cosine > 0.95)
+4. **Distill** — Aggregates top patterns per task type into a single strategy text with confidence score
+
 ---
 
 ## Memory
@@ -831,7 +963,7 @@ The `LLMProvider` interface works with any framework:
 | Vercel AI SDK | `generateText()` → string |
 | Any LLM | Implement `{ generate(messages) → string }` |
 
-> 📂 See [examples/chatbot](examples/chatbot/) for runnable demos with all three frameworks.
+> 📂 See [examples/memory](examples/memory/) for a runnable demo. All three LLM backends supported via `--llm` flag.
 
 > 📦 Full docs: [packages/memory/README.md](packages/memory/README.md)
 
@@ -842,9 +974,10 @@ The `LLMProvider` interface works with any framework:
 | Variable | Description |
 |----------|-------------|
 | `BRAINBANK_REPO` | Default repository path (optional — auto-detected from `.git/` or passed per tool call) |
-| `BRAINBANK_EMBEDDING` | Embedding provider: `local` (default), `openai` |
+| `BRAINBANK_EMBEDDING` | Embedding provider: `local` (default), `openai`, `perplexity`, `perplexity-context` |
 | `BRAINBANK_DEBUG` | Show full stack traces |
 | `OPENAI_API_KEY` | Required when using `BRAINBANK_EMBEDDING=openai` |
+| `PERPLEXITY_API_KEY` | Required when using `BRAINBANK_EMBEDDING=perplexity` or `perplexity-context` |
 
 ---
 
@@ -1102,6 +1235,29 @@ All 9 core grammars verified, each parsing in **<0.05ms**:
 
 > Additional grammars available: C++, Swift, C#, Kotlin, Scala, Lua, Elixir, Bash, HTML, CSS
 
+### RAG Retrieval Quality
+
+BrainBank's hybrid search pipeline (Vector + BM25 → RRF) with Perplexity Context embeddings (2560d):
+
+| Benchmark | Metric | Score |
+|---|---|:---:|
+| **BEIR SciFact** (5,183 docs, 300 queries) | NDCG@10 | **0.761** |
+| **Custom semantic** (127 docs, 20 queries) | R@5 | **83%** |
+
+The hybrid pipeline improved R@5 by **+26pp over vector-only** retrieval on our custom eval.
+
+See **[BENCHMARKS.md](./BENCHMARKS.md)** for full pipeline progression, per-technique impact, and reproduction instructions.
+
+#### Running the RAG Eval
+
+```bash
+# Custom eval on your own docs
+PERPLEXITY_API_KEY=pplx-... npx tsx test/benchmarks/rag/eval.ts --docs ~/path/to/docs
+
+# BEIR standard benchmark
+PERPLEXITY_API_KEY=pplx-... npx tsx test/benchmarks/rag/beir-eval.ts --dataset scifact
+```
+
 ### Running Benchmarks
 
 ```bash
@@ -1110,6 +1266,9 @@ node test/benchmarks/grammar-support.mjs
 
 # Search quality A/B (uses BrainBank's own source files)
 node test/benchmarks/search-quality.mjs
+
+# RAG retrieval quality (requires Perplexity API key + docs folder)
+PERPLEXITY_API_KEY=pplx-... npx tsx test/benchmarks/rag/eval.ts --docs ~/path/to/docs
 ```
 
 ---
@@ -1143,7 +1302,7 @@ node test/benchmarks/search-quality.mjs
 │  └──────────────────────────────────────────────────┘│
 │                                                      │
 │  ┌──────────────────────────────────────────────────┐│
-│  │  Embedding (Local WASM 384d │ OpenAI 1536d)      ││
+│  │  Embedding (Local 384d│OpenAI 1536d│Perplexity)  ││
 │  └──────────────────────────────────────────────────┘│
 │  ┌──────────────────────────────────────────────────┐│
 │  │  Qwen3-Reranker (opt-in cross-encoder)            ││

package/dist/{base-4SUgeRWT.d.ts → base-DZWtdgIf.d.ts}

@@ -203,6 +203,8 @@ interface DocumentResultMetadata {
     seq?: number;
     path?: string;
     searchType?: string;
+    /** Internal chunk ID used by hybrid search to map fused results. */
+    chunkId?: number;
 }
 interface CodeResult {
     type: 'code';
@@ -362,6 +364,9 @@ interface CoEditSuggestion {
  * Wraps hnswlib-node for O(log n) approximate nearest neighbor search.
  * M=16 connections, ef=200 construction, ef=50 search by default.
  * 150x faster than brute force at 1M vectors.
+ *
+ * Supports disk persistence: save(path) / tryLoad(path, count)
+ * to skip costly vector-by-vector rebuild on startup.
  */
 
 declare class HNSWIndex implements VectorIndex {
@@ -407,6 +412,18 @@ declare class HNSWIndex implements VectorIndex {
     search(query: Float32Array, k: number): SearchHit[];
     /** Number of vectors in the index. */
     get size(): number;
+    /**
+     * Save the HNSW graph to disk.
+     * The file can be loaded later with tryLoad() to skip vector-by-vector insertion.
+     */
+    save(path: string): void;
+    /**
+     * Try to load a previously saved HNSW index from disk.
+     * Returns true if loaded successfully, false if stale or missing.
+     * @param path File path to the saved index
+     * @param expectedCount Expected number of vectors (from SQLite) — used to detect staleness
+     */
+    tryLoad(path: string, expectedCount: number): boolean;
 }
 
 /**
@@ -543,40 +560,18 @@ interface Indexer {
     readonly name: string;
     /** Initialize the indexer (create HNSW, load vectors, etc.). */
     initialize(ctx: IndexerContext): Promise<void>;
-    /** Index content (code, git plugins). */
-    index?(options?: any): Promise<any>;
-    /** Search indexed content (docs plugin). */
-    search?(query: string, options?: any): Promise<any[]>;
-    /** Register a document collection (docs plugin). */
-    addCollection?(collection: any): void;
-    /** Remove a collection (docs plugin). */
-    removeCollection?(name: string): void;
-    /** List registered collections (docs plugin). */
-    listCollections?(): any[];
-    /** Index collections (docs plugin). */
-    indexCollections?(options?: any): Promise<any>;
-    /** Add context for a collection path (docs plugin). */
-    addContext?(collection: string, path: string, context: string): void;
-    /** Remove context (docs plugin). */
-    removeContext?(collection: string, path: string): void;
-    /** List context entries (docs plugin). */
-    listContexts?(): any[];
-    /** Watch mode: handle file change (returns true if handled). */
-    onFileChange?(filePath: string, event: 'create' | 'update' | 'delete'): Promise<boolean>;
-    /** Glob patterns for watch mode. */
-    watchPatterns?(): string[];
     /** Return stats for this indexer. */
     stats?(): Record<string, any>;
     /** Clean up resources. */
     close?(): void;
 }
-/** Indexers that can scan and index content. */
+/** Indexers that can scan and index content (code, git). */
 interface IndexablePlugin extends Indexer {
     index(options?: any): Promise<any>;
 }
-/** Indexers that can search indexed content. */
+/** Indexers that can search indexed content (docs). */
 interface SearchablePlugin extends Indexer {
-    search(query: string, options?: any): Promise<any[]>;
+    search(query: string, options?: any): Promise<SearchResult[]>;
 }
 /** Indexers that support file watch mode. */
 interface WatchablePlugin extends Indexer {
@@ -585,10 +580,11 @@ interface WatchablePlugin extends Indexer {
 }
 /** Indexers that manage document collections. */
 interface CollectionPlugin extends Indexer {
-    addCollection(collection: any): void;
+    addCollection(collection: DocumentCollection): void;
     removeCollection(name: string): void;
-    listCollections(): any[];
+    listCollections(): DocumentCollection[];
     indexCollections(options?: any): Promise<any>;
+    search(query: string, options?: any): Promise<SearchResult[]>;
     addContext?(collection: string, path: string, context: string): void;
     removeContext?(collection: string, path: string): void;
     listContexts?(): any[];

package/dist/chunk-6XOXM7MI.js

@@ -0,0 +1,136 @@
+import {
+  decodeBase64Int8
+} from "./chunk-N2OJRXSB.js";
+import {
+  __name
+} from "./chunk-7QVYU63E.js";
+
+// src/providers/embeddings/perplexity-context-embedding.ts
+var DEFAULT_MODEL = "pplx-embed-context-v1-4b";
+var DEFAULT_DIMS = {
+  "pplx-embed-context-v1-0.6b": 1024,
+  "pplx-embed-context-v1-4b": 2560
+};
+var API_URL = "https://api.perplexity.ai/v1/contextualizedembeddings";
+var REQUEST_TIMEOUT_MS = 3e4;
+var BATCH_DELAY_MS = 100;
+var PerplexityContextEmbedding = class {
+  static {
+    __name(this, "PerplexityContextEmbedding");
+  }
+  dims;
+  _apiKey;
+  _model;
+  _baseUrl;
+  _requestDims;
+  _timeout;
+  constructor(options = {}) {
+    this._apiKey = options.apiKey ?? process.env.PERPLEXITY_API_KEY ?? "";
+    this._model = options.model ?? DEFAULT_MODEL;
+    this._baseUrl = options.baseUrl ?? API_URL;
+    this._timeout = options.timeout ?? REQUEST_TIMEOUT_MS;
+    if (options.dims) {
+      this._requestDims = options.dims;
+      this.dims = options.dims;
+    } else {
+      this.dims = DEFAULT_DIMS[this._model] ?? 2560;
+    }
+  }
+  /** Embed a single text. Wraps as [[text]] for the contextualized API. */
+  async embed(text) {
+    const results = await this._request([[text]]);
+    return results[0];
+  }
+  /**
+   * Embed multiple texts as chunks of contextualized documents.
+   * Splits into sub-documents to stay under Perplexity's 32k token/doc limit.
+   */
+  async embedBatch(texts) {
+    if (texts.length === 0) return [];
+    const docs = splitIntoDocuments(texts);
+    const results = [];
+    for (let i = 0; i < docs.length; i++) {
+      if (i > 0) await sleep(BATCH_DELAY_MS);
+      const embeddings = await this._request([docs[i]]);
+      results.push(...embeddings);
+    }
+    return results;
+  }
+  async close() {
+  }
+  /** Send a contextualized request. Input is string[][] (docs × chunks). */
+  async _request(input) {
+    if (!this._apiKey) {
+      throw new Error(
+        "BrainBank: Perplexity API key required. Set PERPLEXITY_API_KEY env var or pass apiKey option."
+      );
+    }
+    const MAX_CHARS = 24e3;
+    const safeInput = input.map(
+      (doc) => doc.map((chunk) => chunk.length > MAX_CHARS ? chunk.slice(0, MAX_CHARS) : chunk)
+    );
+    const body = { model: this._model, input: safeInput };
+    if (this._requestDims) body.dimensions = this._requestDims;
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), this._timeout);
+    let res;
+    try {
+      res = await fetch(this._baseUrl, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "Authorization": `Bearer ${this._apiKey}`
+        },
+        body: JSON.stringify(body),
+        signal: controller.signal
+      });
+    } catch (err) {
+      clearTimeout(timer);
+      if (err instanceof Error && err.name === "AbortError") {
+        throw new Error(`BrainBank: Perplexity contextualized embedding request timed out after ${this._timeout}ms.`);
+      }
+      throw err;
+    } finally {
+      clearTimeout(timer);
+    }
+    if (!res.ok) {
+      const errText = await res.text();
+      throw new Error(`BrainBank: Perplexity contextualized embedding API error (${res.status}): ${errText}`);
+    }
+    const json = await res.json();
+    return flattenContextResponse(json, this.dims);
+  }
+};
+function flattenContextResponse(json, dims) {
+  return json.data.sort((a, b) => a.index - b.index).flatMap(
+    (doc) => doc.data.sort((a, b) => a.index - b.index).map((chunk) => decodeBase64Int8(chunk.embedding, dims))
+  );
+}
+__name(flattenContextResponse, "flattenContextResponse");
+function splitIntoDocuments(texts) {
+  const MAX_CHARS_PER_DOC = 8e4;
+  const docs = [];
+  let current = [];
+  let currentChars = 0;
+  for (const text of texts) {
+    if (current.length > 0 && currentChars + text.length > MAX_CHARS_PER_DOC) {
+      docs.push(current);
+      current = [];
+      currentChars = 0;
+    }
+    current.push(text);
+    currentChars += text.length;
+  }
+  if (current.length > 0) docs.push(current);
+  return docs;
+}
+__name(splitIntoDocuments, "splitIntoDocuments");
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+__name(sleep, "sleep");
+
+export {
+  PerplexityContextEmbedding
+};
+//# sourceMappingURL=chunk-6XOXM7MI.js.map

package/dist/chunk-6XOXM7MI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/providers/embeddings/perplexity-context-embedding.ts"],"sourcesContent":["/**\n * BrainBank — Perplexity Contextualized Embedding Provider\n *\n * Uses Perplexity's contextualized embeddings API for document-aware vectors.\n * Chunks from the same document share context, improving retrieval quality.\n *\n * Models: pplx-embed-context-v1-0.6b (1024d), pplx-embed-context-v1-4b (2560d).\n *\n * Key difference from standard: input is string[][] (docs × chunks) and the\n * response has a nested structure. This provider adapts the flat BrainBank\n * EmbeddingProvider interface to the nested Perplexity API:\n *   - embed(text)       → wraps as [[text]]\n *   - embedBatch(texts) → wraps as [texts] (one \"document\" of related chunks)\n *\n * Usage:\n *   const brain = new BrainBank({\n *     embeddingProvider: new PerplexityContextEmbedding(),\n *   });\n */\n\nimport type { EmbeddingProvider } from '@/types.ts';\nimport { decodeBase64Int8 } from './perplexity-embedding.ts';\n\nconst DEFAULT_MODEL = 'pplx-embed-context-v1-4b';\nconst DEFAULT_DIMS: Record<string, number> = {\n    'pplx-embed-context-v1-0.6b': 1024,\n    'pplx-embed-context-v1-4b': 2560,\n};\nconst API_URL = 'https://api.perplexity.ai/v1/contextualizedembeddings';\nconst MAX_BATCH = 100;\nconst REQUEST_TIMEOUT_MS = 30_000;\nconst BATCH_DELAY_MS = 100;\n\nexport interface PerplexityContextEmbeddingOptions {\n    /** Perplexity API key. Falls back to PERPLEXITY_API_KEY env var. */\n    apiKey?: string;\n    /** Model name. Default: 'pplx-embed-context-v1-4b' */\n    model?: string;\n    /** Vector dimensions (Matryoshka reduction). If omitted, uses model default. */\n    dims?: number;\n    /** Base URL override. */\n    baseUrl?: string;\n    /** Request timeout in ms. Default: 30000 */\n    timeout?: number;\n}\n\nexport class PerplexityContextEmbedding implements EmbeddingProvider {\n    readonly dims: number;\n\n    private _apiKey: string;\n    private _model: string;\n    private _baseUrl: string;\n    private _requestDims: number | undefined;\n    private _timeout: number;\n\n    constructor(options: PerplexityContextEmbeddingOptions = {}) {\n        this._apiKey = options.apiKey ?? process.env.PERPLEXITY_API_KEY ?? '';\n        this._model = options.model ?? DEFAULT_MODEL;\n        this._baseUrl = options.baseUrl ?? API_URL;\n        this._timeout = options.timeout ?? REQUEST_TIMEOUT_MS;\n\n        if (options.dims) {\n            this._requestDims = options.dims;\n            this.dims = options.dims;\n        } else {\n            this.dims = DEFAULT_DIMS[this._model] ?? 2560;\n        }\n    }\n\n    /** Embed a single text. Wraps as [[text]] for the contextualized API. */\n    async embed(text: string): Promise<Float32Array> {\n        const results = await this._request([[text]]);\n        return results[0];\n    }\n\n    /**\n     * Embed multiple texts as chunks of contextualized documents.\n     * Splits into sub-documents to stay under Perplexity's 32k token/doc limit.\n     */\n    async embedBatch(texts: string[]): Promise<Float32Array[]> {\n        if (texts.length === 0) return [];\n\n        const docs = splitIntoDocuments(texts);\n        const results: Float32Array[] = [];\n\n        for (let i = 0; i < docs.length; i++) {\n            if (i > 0) await sleep(BATCH_DELAY_MS);\n            const embeddings = await this._request([docs[i]]);\n            results.push(...embeddings);\n        }\n\n        return results;\n    }\n\n    async close(): Promise<void> {\n        // No resources to release\n    }\n\n    /** Send a contextualized request. Input is string[][] (docs × chunks). */\n    private async _request(input: string[][]): Promise<Float32Array[]> {\n        if (!this._apiKey) {\n            throw new Error(\n                'BrainBank: Perplexity API key required. Set PERPLEXITY_API_KEY env var or pass apiKey option.',\n            );\n        }\n\n        const MAX_CHARS = 24_000;\n        const safeInput = input.map(doc =>\n            doc.map(chunk => chunk.length > MAX_CHARS ? chunk.slice(0, MAX_CHARS) : chunk),\n        );\n\n        const body: Record<string, unknown> = { model: this._model, input: safeInput };\n        if (this._requestDims) body.dimensions = this._requestDims;\n\n        const controller = new AbortController();\n        const timer = setTimeout(() => controller.abort(), this._timeout);\n\n        let res: Response;\n        try {\n            res = await fetch(this._baseUrl, {\n                method: 'POST',\n                headers: {\n                    'Content-Type': 'application/json',\n                    'Authorization': `Bearer ${this._apiKey}`,\n                },\n                body: JSON.stringify(body),\n                signal: controller.signal,\n            });\n        } catch (err: unknown) {\n            clearTimeout(timer);\n            if (err instanceof Error && err.name === 'AbortError') {\n                throw new Error(`BrainBank: Perplexity contextualized embedding request timed out after ${this._timeout}ms.`);\n            }\n            throw err;\n        } finally {\n            clearTimeout(timer);\n        }\n\n        if (!res.ok) {\n            const errText = await res.text();\n            throw new Error(`BrainBank: Perplexity contextualized embedding API error (${res.status}): ${errText}`);\n        }\n\n        const json = await res.json() as PerplexityContextResponse;\n        return flattenContextResponse(json, this.dims);\n    }\n}\n\n// ── Response Types ──────────────────────────────────\n\ninterface PerplexityContextResponse {\n    data: Array<{\n        index: number;\n        data: Array<{ index: number; embedding: string }>;\n    }>;\n}\n\n/** Flatten nested doc → chunk response into a single flat array. */\nfunction flattenContextResponse(json: PerplexityContextResponse, dims: number): Float32Array[] {\n    return json.data\n        .sort((a, b) => a.index - b.index)\n        .flatMap(doc =>\n            doc.data\n                .sort((a, b) => a.index - b.index)\n                .map(chunk => decodeBase64Int8(chunk.embedding, dims)),\n        );\n}\n\n/**\n * Split chunks into sub-documents that each stay under the 32k token limit.\n * Uses ~4 chars/token estimate with safety margin (~80k chars ≈ ~20k tokens).\n */\nfunction splitIntoDocuments(texts: string[]): string[][] {\n    const MAX_CHARS_PER_DOC = 80_000;\n    const docs: string[][] = [];\n    let current: string[] = [];\n    let currentChars = 0;\n\n    for (const text of texts) {\n        if (current.length > 0 && currentChars + text.length > MAX_CHARS_PER_DOC) {\n            docs.push(current);\n            current = [];\n            currentChars = 0;\n        }\n        current.push(text);\n        currentChars += text.length;\n    }\n\n    if (current.length > 0) docs.push(current);\n    return docs;\n}\n\n/** Simple delay helper. */\nfunction sleep(ms: number): Promise<void> {\n    return new Promise(resolve => setTimeout(resolve, ms));\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-FINIFKAY.js → chunk-BNV43SEF.js}

@@ -1,6 +1,7 @@
 import {
-  cosineSimilarity
-} from "./chunk-QNHBCOKB.js";
+  cosineSimilarity,
+  vecToBuffer
+} from "./chunk-U2Q2XGPZ.js";
 import {
   __name
 } from "./chunk-7QVYU63E.js";
@@ -37,7 +38,7 @@ var PatternStore = class {
     const vec = await this._deps.embedding.embed(text);
     this._deps.db.prepare(
       "INSERT INTO memory_vectors (pattern_id, embedding) VALUES (?, ?)"
-    ).run(id, Buffer.from(vec.buffer));
+    ).run(id, vecToBuffer(vec));
     this._deps.hnsw.add(vec, id);
     this._deps.vectorCache.set(id, vec);
     return id;
@@ -300,4 +301,4 @@ export {
   Consolidator,
   memory
 };
-//# sourceMappingURL=chunk-FINIFKAY.js.map
+//# sourceMappingURL=chunk-BNV43SEF.js.map

package/dist/chunk-BNV43SEF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/indexers/memory/pattern-store.ts","../src/indexers/memory/consolidator.ts","../src/indexers/memory/distiller.ts","../src/indexers/memory/memory-plugin.ts"],"sourcesContent":["/**\n * BrainBank — Pattern Store (Agent Memory)\n * \n * Stores what the agent learned from past tasks.\n * Each pattern records task, approach, and success rate.\n * Searchable by semantic similarity via HNSW.\n */\n\nimport type { Database } from '@/db/database.ts';\nimport { vecToBuffer } from '@/lib/math.ts';\nimport type { EmbeddingProvider, LearningPattern } from '@/types.ts';\nimport type { HNSWIndex } from '@/providers/vector/hnsw-index.ts';\n\nexport interface PatternStoreDeps {\n    db: Database;\n    hnsw: HNSWIndex;\n    vectorCache: Map<number, Float32Array>;\n    embedding: EmbeddingProvider;\n}\n\nexport class PatternStore {\n    private _deps: PatternStoreDeps;\n\n    constructor(deps: PatternStoreDeps) {\n        this._deps = deps;\n    }\n\n    /**\n     * Store a learned pattern.\n     * Returns the pattern ID.\n     */\n    async learn(pattern: LearningPattern): Promise<number> {\n        const result = this._deps.db.prepare(`\n            INSERT INTO memory_patterns (task_type, task, approach, outcome, success_rate, critique, tokens_used, latency_ms)\n            VALUES (?, ?, ?, ?, ?, ?, ?, ?)\n        `).run(\n            pattern.taskType,\n            pattern.task,\n            pattern.approach,\n            pattern.outcome ?? null,\n            pattern.successRate,\n            pattern.critique ?? null,\n            pattern.tokensUsed ?? null,\n            pattern.latencyMs ?? null,\n        );\n\n        const id = Number(result.lastInsertRowid);\n\n        // Embed and store vector\n        const text = `${pattern.taskType} ${pattern.task} ${pattern.approach}`;\n        const vec = await this._deps.embedding.embed(text);\n\n        this._deps.db.prepare(\n            'INSERT INTO memory_vectors (pattern_id, embedding) VALUES (?, ?)'\n        ).run(id, vecToBuffer(vec));\n\n        this._deps.hnsw.add(vec, id);\n        this._deps.vectorCache.set(id, vec);\n\n        return id;\n    }\n\n    /**\n     * Search for similar successful patterns.\n     * Filters by minimum success rate.\n     */\n    async search(query: string, k: number = 4, minSuccess: number = 0.5): Promise<(LearningPattern & { score: number })[]> {\n        if (this._deps.hnsw.size === 0) return [];\n\n        const vec = await this._deps.embedding.embed(query);\n        const hits = this._deps.hnsw.search(vec, k * 2);\n\n        if (hits.length === 0) return [];\n\n        const ids = hits.map(h => h.id);\n        const scoreMap = new Map(hits.map(h => [h.id, h.score]));\n\n        const placeholders = ids.map(() => '?').join(',');\n        const rows = this._deps.db.prepare(\n            `SELECT * FROM memory_patterns WHERE id IN (${placeholders}) AND success_rate >= ?`\n        ).all(...ids, minSuccess) as any[];\n\n        return rows\n            .map(r => ({\n                id: r.id,\n                taskType: r.task_type,\n                task: r.task,\n                approach: r.approach,\n                outcome: r.outcome,\n                successRate: r.success_rate,\n                critique: r.critique,\n                tokensUsed: r.tokens_used,\n                latencyMs: r.latency_ms,\n                score: scoreMap.get(r.id) ?? 0,\n            }))\n            .sort((a, b) => b.score - a.score)\n            .slice(0, k);\n    }\n\n    /**\n     * Get all patterns for a specific task type.\n     */\n    getByTaskType(taskType: string, limit: number = 20): LearningPattern[] {\n        const rows = this._deps.db.prepare(\n            `SELECT * FROM memory_patterns WHERE task_type = ? ORDER BY success_rate DESC LIMIT ?`\n        ).all(taskType, limit) as any[];\n\n        return rows.map(r => ({\n            id: r.id,\n            taskType: r.task_type,\n            task: r.task,\n            approach: r.approach,\n            outcome: r.outcome,\n            successRate: r.success_rate,\n            critique: r.critique,\n            tokensUsed: r.tokens_used,\n            latencyMs: r.latency_ms,\n        }));\n    }\n\n    /** Total number of stored patterns. */\n    get count(): number {\n        return (this._deps.db.prepare('SELECT COUNT(*) as c FROM memory_patterns').get() as any).c;\n    }\n}\n","/**\n * BrainBank — Consolidator\n * \n * Maintenance operations for the agent memory:\n *   - prune: remove old failed patterns\n *   - dedup: merge near-duplicate patterns (cosine > 0.95)\n *   - consolidate: run both\n */\n\nimport type { Database } from '@/db/database.ts';\nimport { cosineSimilarity } from '@/lib/math.ts';\n\nexport class Consolidator {\n    constructor(\n        private _db: Database,\n        private _vectorCache: Map<number, Float32Array>,\n    ) {}\n\n    /**\n     * Remove old failed patterns.\n     * Criteria: success_rate < 0.3 AND created > 90 days ago.\n     */\n    prune(maxAgeDays: number = 90, minSuccess: number = 0.3): number {\n        const cutoff = Math.floor(Date.now() / 1000) - maxAgeDays * 86400;\n        const result = this._db.prepare(\n            'DELETE FROM memory_patterns WHERE success_rate < ? AND created_at < ?'\n        ).run(minSuccess, cutoff);\n        return result.changes;\n    }\n\n    /**\n     * Merge near-duplicate patterns.\n     * Keeps the one with higher success_rate.\n     * Threshold: cosine similarity > 0.95.\n     */\n    dedup(threshold: number = 0.95): number {\n        const entries = Array.from(this._vectorCache.entries());\n        const toDelete = new Set<number>();\n\n        for (let i = 0; i < entries.length; i++) {\n            if (toDelete.has(entries[i][0])) continue;\n\n            for (let j = i + 1; j < entries.length; j++) {\n                if (toDelete.has(entries[j][0])) continue;\n\n                const sim = cosineSimilarity(entries[i][1], entries[j][1]);\n                if (sim > threshold) {\n                    // Keep the one with higher success rate\n                    const pi = this._db.prepare(\n                        'SELECT success_rate FROM memory_patterns WHERE id = ?'\n                    ).get(entries[i][0]) as any;\n                    const pj = this._db.prepare(\n                        'SELECT success_rate FROM memory_patterns WHERE id = ?'\n                    ).get(entries[j][0]) as any;\n\n                    if (pi && pj) {\n                        const deleteId = pi.success_rate >= pj.success_rate\n                            ? entries[j][0]\n                            : entries[i][0];\n                        toDelete.add(deleteId);\n                    }\n                }\n            }\n        }\n\n        if (toDelete.size > 0) {\n            const ids = Array.from(toDelete);\n            const placeholders = ids.map(() => '?').join(',');\n            this._db.prepare(\n                `DELETE FROM memory_patterns WHERE id IN (${placeholders})`\n            ).run(...ids);\n\n            // Clean vector cache\n            for (const id of ids) {\n                this._vectorCache.delete(id);\n            }\n        }\n\n        return toDelete.size;\n    }\n\n    /**\n     * Run full consolidation: prune + dedup.\n     */\n    consolidate(): { pruned: number; deduped: number } {\n        const pruned = this.prune();\n        const deduped = this.dedup();\n        return { pruned, deduped };\n    }\n}\n","/**\n * BrainBank — Strategy Distiller\n * \n * Aggregates top patterns for a task type into a single strategy text.\n * Analogous to SONA's Deep Loop — periodic knowledge distillation.\n */\n\nimport type { Database } from '@/db/database.ts';\nimport type { DistilledStrategy } from '@/types.ts';\n\nexport class StrategyDistiller {\n    constructor(private _db: Database) {}\n\n    /**\n     * Distill top patterns for a task type into a strategy.\n     * Updates the distilled_strategies table.\n     */\n    distill(taskType: string, topK: number = 10): DistilledStrategy | null {\n        const patterns = this._db.prepare(`\n            SELECT task, approach, outcome, critique, success_rate\n            FROM memory_patterns\n            WHERE task_type = ? AND success_rate >= 0.7\n            ORDER BY success_rate DESC, created_at DESC\n            LIMIT ?\n        `).all(taskType, topK) as any[];\n\n        if (patterns.length === 0) return null;\n\n        // Build strategy text from top patterns\n        const lines: string[] = [];\n        const avgSuccess = patterns.reduce((sum: number, p: any) => sum + p.success_rate, 0) / patterns.length;\n\n        lines.push(`Strategy for \"${taskType}\" (${patterns.length} patterns, avg success ${Math.round(avgSuccess * 100)}%):`);\n        lines.push('');\n\n        for (const p of patterns) {\n            lines.push(`• ${p.approach} (${Math.round(p.success_rate * 100)}%)`);\n            if (p.critique) lines.push(`  └ ${p.critique}`);\n        }\n\n        const strategy = lines.join('\\n');\n        const confidence = avgSuccess;\n        const now = Math.floor(Date.now() / 1000);\n\n        this._db.prepare(`\n            INSERT INTO distilled_strategies (task_type, strategy, confidence, updated_at)\n            VALUES (?, ?, ?, ?)\n            ON CONFLICT(task_type) DO UPDATE SET\n                strategy = excluded.strategy,\n                confidence = excluded.confidence,\n                updated_at = excluded.updated_at\n        `).run(taskType, strategy, confidence, now);\n\n        return { taskType, strategy, confidence, updatedAt: now };\n    }\n\n    /**\n     * Get a distilled strategy for a task type.\n     */\n    get(taskType: string): DistilledStrategy | null {\n        const row = this._db.prepare(\n            'SELECT * FROM distilled_strategies WHERE task_type = ?'\n        ).get(taskType) as any;\n\n        if (!row) return null;\n        return {\n            taskType: row.task_type,\n            strategy: row.strategy,\n            confidence: row.confidence,\n            updatedAt: row.updated_at,\n        };\n    }\n\n    /**\n     * List all distilled strategies.\n     */\n    list(): DistilledStrategy[] {\n        const rows = this._db.prepare(\n            'SELECT * FROM distilled_strategies ORDER BY confidence DESC'\n        ).all() as any[];\n\n        return rows.map(r => ({\n            taskType: r.task_type,\n            strategy: r.strategy,\n            confidence: r.confidence,\n            updatedAt: r.updated_at,\n        }));\n    }\n}\n","/**\n * BrainBank — Memory Plugin\n * \n * Agent learns from completed tasks — stores patterns,\n * consolidates failures, distills strategies.\n * \n *   import { memory } from 'brainbank/memory';\n *   brain.use(memory());\n */\n\nimport type { Indexer, IndexerContext } from '@/indexers/base.ts';\nimport type { HNSWIndex } from '@/providers/vector/hnsw-index.ts';\nimport type { Database } from '@/db/database.ts';\nimport { PatternStore } from './pattern-store.ts';\nimport { Consolidator } from './consolidator.ts';\nimport { StrategyDistiller } from './distiller.ts';\nimport type { LearningPattern, DistilledStrategy } from '@/types.ts';\n\nclass MemoryPlugin implements Indexer {\n    readonly name = 'memory';\n    hnsw!: HNSWIndex;\n    patternStore!: PatternStore;\n    consolidator!: Consolidator;\n    distiller!: StrategyDistiller;\n    vecCache = new Map<number, Float32Array>();\n    private _db!: Database;\n\n    async initialize(ctx: IndexerContext): Promise<void> {\n        this._db = ctx.db;\n        this.hnsw = await ctx.createHnsw(100_000);\n        ctx.loadVectors('memory_vectors', 'pattern_id', this.hnsw, this.vecCache);\n\n        this.patternStore = new PatternStore({\n            db: ctx.db,\n            hnsw: this.hnsw,\n            vectorCache: this.vecCache,\n            embedding: ctx.embedding,\n        });\n\n        this.consolidator = new Consolidator(ctx.db, this.vecCache);\n        this.distiller = new StrategyDistiller(ctx.db);\n    }\n\n    /** Store a learned pattern. */\n    async learn(pattern: LearningPattern): Promise<number> {\n        const id = await this.patternStore.learn(pattern);\n\n        // Auto-consolidate every 50 patterns (guard against count=0)\n        if (this.patternStore.count > 0 && this.patternStore.count % 50 === 0) {\n            this.consolidator.consolidate();\n        }\n\n        return id;\n    }\n\n    /** Search for similar patterns. */\n    async search(query: string, k: number = 4): Promise<(LearningPattern & { score: number })[]> {\n        return this.patternStore.search(query, k);\n    }\n\n    /** Consolidate: prune old failures + deduplicate. */\n    consolidate(): { pruned: number; deduped: number } {\n        return this.consolidator.consolidate();\n    }\n\n    /** Distill patterns into a strategy. */\n    distill(taskType: string): DistilledStrategy | null {\n        return this.distiller.distill(taskType);\n    }\n\n    stats(): Record<string, any> {\n        return {\n            patterns: this.patternStore.count,\n            avgSuccess: (this._db.prepare('SELECT AVG(success_rate) as a FROM memory_patterns').get() as any).a ?? 0,\n            hnswSize: this.hnsw.size,\n        };\n    }\n}\n\n/** Create an agent memory plugin. */\nexport function memory(): Indexer {\n    return new MemoryPlugin();\n}\n"],"mappings":";;;;;;;;;AAoBO,IAAM,eAAN,MAAmB;AAAA,EApB1B,OAoB0B;AAAA;AAAA;AAAA,EACd;AAAA,EAER,YAAY,MAAwB;AAChC,SAAK,QAAQ;AAAA,EACjB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,MAAM,SAA2C;AACnD,UAAM,SAAS,KAAK,MAAM,GAAG,QAAQ;AAAA;AAAA;AAAA,SAGpC,EAAE;AAAA,MACC,QAAQ;AAAA,MACR,QAAQ;AAAA,MACR,QAAQ;AAAA,MACR,QAAQ,WAAW;AAAA,MACnB,QAAQ;AAAA,MACR,QAAQ,YAAY;AAAA,MACpB,QAAQ,cAAc;AAAA,MACtB,QAAQ,aAAa;AAAA,IACzB;AAEA,UAAM,KAAK,OAAO,OAAO,eAAe;AAGxC,UAAM,OAAO,GAAG,QAAQ,QAAQ,IAAI,QAAQ,IAAI,IAAI,QAAQ,QAAQ;AACpE,UAAM,MAAM,MAAM,KAAK,MAAM,UAAU,MAAM,IAAI;AAEjD,SAAK,MAAM,GAAG;AAAA,MACV;AAAA,IACJ,EAAE,IAAI,IAAI,YAAY,GAAG,CAAC;AAE1B,SAAK,MAAM,KAAK,IAAI,KAAK,EAAE;AAC3B,SAAK,MAAM,YAAY,IAAI,IAAI,GAAG;AAElC,WAAO;AAAA,EACX;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,OAAO,OAAe,IAAY,GAAG,aAAqB,KAAuD;AACnH,QAAI,KAAK,MAAM,KAAK,SAAS,EAAG,QAAO,CAAC;AAExC,UAAM,MAAM,MAAM,KAAK,MAAM,UAAU,MAAM,KAAK;AAClD,UAAM,OAAO,KAAK,MAAM,KAAK,OAAO,KAAK,IAAI,CAAC;AAE9C,QAAI,KAAK,WAAW,EAAG,QAAO,CAAC;AAE/B,UAAM,MAAM,KAAK,IAAI,OAAK,EAAE,EAAE;AAC9B,UAAM,WAAW,IAAI,IAAI,KAAK,IAAI,OAAK,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;AAEvD,UAAM,eAAe,IAAI,IAAI,MAAM,GAAG,EAAE,KAAK,GAAG;AAChD,UAAM,OAAO,KAAK,MAAM,GAAG;AAAA,MACvB,8CAA8C,YAAY;AAAA,IAC9D,EAAE,IAAI,GAAG,KAAK,UAAU;AAExB,WAAO,KACF,IAAI,QAAM;AAAA,MACP,IAAI,EAAE;AAAA,MACN,UAAU,EAAE;AAAA,MACZ,MAAM,EAAE;AAAA,MACR,UAAU,EAAE;AAAA,MACZ,SAAS,EAAE;AAAA,MACX,aAAa,EAAE;AAAA,MACf,UAAU,EAAE;AAAA,MACZ,YAAY,EAAE;AAAA,MACd,WAAW,EAAE;AAAA,MACb,OAAO,SAAS,IAAI,EAAE,EAAE,KAAK;AAAA,IACjC,EAAE,EACD,KAAK,CAAC,GAAG,MAAM,EAAE,QAAQ,EAAE,KAAK,EAChC,MAAM,GAAG,CAAC;AAAA,EACnB;AAAA;AAAA;AAAA;AAAA,EAKA,cAAc,UAAkB,QAAgB,IAAuB;AACnE,UAAM,OAAO,KAAK,MAAM,GAAG;AAAA,MACvB;AAAA,IACJ,EAAE,IAAI,UAAU,KAAK;AAErB,WAAO,KAAK,IAAI,QAAM;AAAA,MAClB,IAAI,EAAE;AAAA,MACN,UAAU,EAAE;AAAA,MACZ,MAAM,EAAE;AAAA,MACR,UAAU,EAAE;AAAA,MACZ,SAAS,EAAE;AAAA,MACX,aAAa,EAAE;AAAA,MACf,UAAU,EAAE;AAAA,MACZ,YAAY,EAAE;AAAA,MACd,WAAW,EAAE;AAAA,IACjB,EAAE;AAAA,EACN;AAAA;AAAA,EAGA,IAAI,QAAgB;AAChB,WAAQ,KAAK,MAAM,GAAG,QAAQ,2CAA2C,EAAE,IAAI,EAAU;AAAA,EAC7F;AACJ;;;AChHO,IAAM,eAAN,MAAmB;AAAA,EACtB,YACY,KACA,cACV;AAFU;AACA;AAAA,EACT;AAAA,EAhBP,OAY0B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUtB,MAAM,aAAqB,IAAI,aAAqB,KAAa;AAC7D,UAAM,SAAS,KAAK,MAAM,KAAK,IAAI,IAAI,GAAI,IAAI,aAAa;AAC5D,UAAM,SAAS,KAAK,IAAI;AAAA,MACpB;AAAA,IACJ,EAAE,IAAI,YAAY,MAAM;AACxB,WAAO,OAAO;AAAA,EAClB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,YAAoB,MAAc;AACpC,UAAM,UAAU,MAAM,KAAK,KAAK,aAAa,QAAQ,CAAC;AACtD,UAAM,WAAW,oBAAI,IAAY;AAEjC,aAAS,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK;AACrC,UAAI,SAAS,IAAI,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAG;AAEjC,eAAS,IAAI,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK;AACzC,YAAI,SAAS,IAAI,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAG;AAEjC,cAAM,MAAM,iBAAiB,QAAQ,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;AACzD,YAAI,MAAM,WAAW;AAEjB,gBAAM,KAAK,KAAK,IAAI;AAAA,YAChB;AAAA,UACJ,EAAE,IAAI,QAAQ,CAAC,EAAE,CAAC,CAAC;AACnB,gBAAM,KAAK,KAAK,IAAI;AAAA,YAChB;AAAA,UACJ,EAAE,IAAI,QAAQ,CAAC,EAAE,CAAC,CAAC;AAEnB,cAAI,MAAM,IAAI;AACV,kBAAM,WAAW,GAAG,gBAAgB,GAAG,eACjC,QAAQ,CAAC,EAAE,CAAC,IACZ,QAAQ,CAAC,EAAE,CAAC;AAClB,qBAAS,IAAI,QAAQ;AAAA,UACzB;AAAA,QACJ;AAAA,MACJ;AAAA,IACJ;AAEA,QAAI,SAAS,OAAO,GAAG;AACnB,YAAM,MAAM,MAAM,KAAK,QAAQ;AAC/B,YAAM,eAAe,IAAI,IAAI,MAAM,GAAG,EAAE,KAAK,GAAG;AAChD,WAAK,IAAI;AAAA,QACL,4CAA4C,YAAY;AAAA,MAC5D,EAAE,IAAI,GAAG,GAAG;AAGZ,iBAAW,MAAM,KAAK;AAClB,aAAK,aAAa,OAAO,EAAE;AAAA,MAC/B;AAAA,IACJ;AAEA,WAAO,SAAS;AAAA,EACpB;AAAA;AAAA;AAAA;AAAA,EAKA,cAAmD;AAC/C,UAAM,SAAS,KAAK,MAAM;AAC1B,UAAM,UAAU,KAAK,MAAM;AAC3B,WAAO,EAAE,QAAQ,QAAQ;AAAA,EAC7B;AACJ;;;AC/EO,IAAM,oBAAN,MAAwB;AAAA,EAC3B,YAAoB,KAAe;AAAf;AAAA,EAAgB;AAAA,EAXxC,OAU+B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAO3B,QAAQ,UAAkB,OAAe,IAA8B;AACnE,UAAM,WAAW,KAAK,IAAI,QAAQ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,SAMjC,EAAE,IAAI,UAAU,IAAI;AAErB,QAAI,SAAS,WAAW,EAAG,QAAO;AAGlC,UAAM,QAAkB,CAAC;AACzB,UAAM,aAAa,SAAS,OAAO,CAAC,KAAa,MAAW,MAAM,EAAE,cAAc,CAAC,IAAI,SAAS;AAEhG,UAAM,KAAK,iBAAiB,QAAQ,MAAM,SAAS,MAAM,0BAA0B,KAAK,MAAM,aAAa,GAAG,CAAC,KAAK;AACpH,UAAM,KAAK,EAAE;AAEb,eAAW,KAAK,UAAU;AACtB,YAAM,KAAK,UAAK,EAAE,QAAQ,KAAK,KAAK,MAAM,EAAE,eAAe,GAAG,CAAC,IAAI;AACnE,UAAI,EAAE,SAAU,OAAM,KAAK,YAAO,EAAE,QAAQ,EAAE;AAAA,IAClD;AAEA,UAAM,WAAW,MAAM,KAAK,IAAI;AAChC,UAAM,aAAa;AACnB,UAAM,MAAM,KAAK,MAAM,KAAK,IAAI,IAAI,GAAI;AAExC,SAAK,IAAI,QAAQ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,SAOhB,EAAE,IAAI,UAAU,UAAU,YAAY,GAAG;AAE1C,WAAO,EAAE,UAAU,UAAU,YAAY,WAAW,IAAI;AAAA,EAC5D;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,UAA4C;AAC5C,UAAM,MAAM,KAAK,IAAI;AAAA,MACjB;AAAA,IACJ,EAAE,IAAI,QAAQ;AAEd,QAAI,CAAC,IAAK,QAAO;AACjB,WAAO;AAAA,MACH,UAAU,IAAI;AAAA,MACd,UAAU,IAAI;AAAA,MACd,YAAY,IAAI;AAAA,MAChB,WAAW,IAAI;AAAA,IACnB;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA,EAKA,OAA4B;AACxB,UAAM,OAAO,KAAK,IAAI;AAAA,MAClB;AAAA,IACJ,EAAE,IAAI;AAEN,WAAO,KAAK,IAAI,QAAM;AAAA,MAClB,UAAU,EAAE;AAAA,MACZ,UAAU,EAAE;AAAA,MACZ,YAAY,EAAE;AAAA,MACd,WAAW,EAAE;AAAA,IACjB,EAAE;AAAA,EACN;AACJ;;;ACtEA,IAAM,eAAN,MAAsC;AAAA,EAlBtC,OAkBsC;AAAA;AAAA;AAAA,EACzB,OAAO;AAAA,EAChB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,WAAW,oBAAI,IAA0B;AAAA,EACjC;AAAA,EAER,MAAM,WAAW,KAAoC;AACjD,SAAK,MAAM,IAAI;AACf,SAAK,OAAO,MAAM,IAAI,WAAW,GAAO;AACxC,QAAI,YAAY,kBAAkB,cAAc,KAAK,MAAM,KAAK,QAAQ;AAExE,SAAK,eAAe,IAAI,aAAa;AAAA,MACjC,IAAI,IAAI;AAAA,MACR,MAAM,KAAK;AAAA,MACX,aAAa,KAAK;AAAA,MAClB,WAAW,IAAI;AAAA,IACnB,CAAC;AAED,SAAK,eAAe,IAAI,aAAa,IAAI,IAAI,KAAK,QAAQ;AAC1D,SAAK,YAAY,IAAI,kBAAkB,IAAI,EAAE;AAAA,EACjD;AAAA;AAAA,EAGA,MAAM,MAAM,SAA2C;AACnD,UAAM,KAAK,MAAM,KAAK,aAAa,MAAM,OAAO;AAGhD,QAAI,KAAK,aAAa,QAAQ,KAAK,KAAK,aAAa,QAAQ,OAAO,GAAG;AACnE,WAAK,aAAa,YAAY;AAAA,IAClC;AAEA,WAAO;AAAA,EACX;AAAA;AAAA,EAGA,MAAM,OAAO,OAAe,IAAY,GAAqD;AACzF,WAAO,KAAK,aAAa,OAAO,OAAO,CAAC;AAAA,EAC5C;AAAA;AAAA,EAGA,cAAmD;AAC/C,WAAO,KAAK,aAAa,YAAY;AAAA,EACzC;AAAA;AAAA,EAGA,QAAQ,UAA4C;AAChD,WAAO,KAAK,UAAU,QAAQ,QAAQ;AAAA,EAC1C;AAAA,EAEA,QAA6B;AACzB,WAAO;AAAA,MACH,UAAU,KAAK,aAAa;AAAA,MAC5B,YAAa,KAAK,IAAI,QAAQ,oDAAoD,EAAE,IAAI,EAAU,KAAK;AAAA,MACvG,UAAU,KAAK,KAAK;AAAA,IACxB;AAAA,EACJ;AACJ;AAGO,SAAS,SAAkB;AAC9B,SAAO,IAAI,aAAa;AAC5B;AAFgB;","names":[]}