agentic-qe 3.6.19 → 3.7.0

package/v3/dist/integrations/ruvector/rvf-native-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rvf-native-adapter.js","sourceRoot":"","sources":["../../../src/integrations/ruvector/rvf-native-adapter.ts"],"names":[],"mappings":"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"}

package/v3/dist/kernel/hnsw-adapter.d.ts

@@ -0,0 +1,99 @@
+/**
+ * HNSW Adapter
+ *
+ * Wraps ProgressiveHnswBackend and provides backward-compatible APIs for
+ * existing callers that use InMemoryHNSWIndex or RuvectorFlatIndex interfaces.
+ *
+ * Named indexes: patterns, qe-memory, learning, coverage
+ *
+ * @see ADR-071: HNSW Implementation Unification
+ * @module kernel/hnsw-adapter
+ */
+import type { IHnswIndexProvider, SearchResult, HnswConfig } from './hnsw-index-provider.js';
+/**
+ * Well-known index names used across the AQE platform.
+ */
+export type HnswIndexName = 'patterns' | 'qe-memory' | 'learning' | 'coverage';
+/**
+ * Adapter that wraps ProgressiveHnswBackend and provides backward-compatible
+ * APIs matching the old InMemoryHNSWIndex and RuvectorFlatIndex interfaces.
+ *
+ * This adapter bridges the gap between the new IHnswIndexProvider interface
+ * and existing callers that use string-based IDs and number[] vectors.
+ */
+export declare class HnswAdapter implements IHnswIndexProvider {
+    private readonly backend;
+    private readonly indexName;
+    /** Maps string keys to numeric IDs (for backward compat with old APIs) */
+    private stringToNumericId;
+    private numericToStringId;
+    private nextAutoId;
+    constructor(name: string, config?: Partial<HnswConfig>);
+    add(id: number, vector: Float32Array, metadata?: Record<string, unknown>): void;
+    search(query: Float32Array, k: number): SearchResult[];
+    remove(id: number): boolean;
+    size(): number;
+    dimensions(): number;
+    recall(): number;
+    /**
+     * Add a vector using a string ID (backward compat with InMemoryHNSWIndex).
+     *
+     * @param id - String identifier
+     * @param embedding - Vector as number[]
+     */
+    addByStringId(id: string, embedding: number[]): void;
+    /**
+     * Search using a number[] query (backward compat with InMemoryHNSWIndex).
+     *
+     * @param query - Query vector as number[]
+     * @param k - Number of results
+     * @returns Results with string IDs and scores
+     */
+    searchByArray(query: number[], k: number): Array<{
+        id: string;
+        score: number;
+    }>;
+    /**
+     * Remove by string ID (backward compat with InMemoryHNSWIndex).
+     */
+    removeByStringId(id: string): boolean;
+    /**
+     * Clear all vectors from the index.
+     */
+    clear(): void;
+    /**
+     * Check whether @ruvector/gnn is available.
+     */
+    isRuvectorAvailable(): boolean;
+    /**
+     * Get the index name.
+     */
+    getName(): string;
+    /**
+     * Create or retrieve a named HNSW index.
+     *
+     * Uses a singleton registry so the same name always returns the same instance.
+     *
+     * @param name - Index name (e.g. 'patterns', 'qe-memory', 'learning', 'coverage')
+     * @param config - Optional configuration overrides
+     * @returns IHnswIndexProvider instance
+     */
+    static create(name: string, config?: Partial<HnswConfig>): HnswAdapter;
+    /**
+     * Get an existing named index, or undefined if not created.
+     */
+    static get(name: string): HnswAdapter | undefined;
+    /**
+     * Close and remove a named index from the registry.
+     */
+    static close(name: string): void;
+    /**
+     * Close all named indexes.
+     */
+    static closeAll(): void;
+    /**
+     * List all registered index names.
+     */
+    static listIndexes(): string[];
+}
+//# sourceMappingURL=hnsw-adapter.d.ts.map

package/v3/dist/kernel/hnsw-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hnsw-adapter.d.ts","sourceRoot":"","sources":["../../src/kernel/hnsw-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,kBAAkB,EAClB,YAAY,EACZ,UAAU,EACX,MAAM,0BAA0B,CAAC;AAQlC;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU,GAAG,UAAU,CAAC;AA8C/E;;;;;;GAMG;AACH,qBAAa,WAAY,YAAW,kBAAkB;IACpD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAEnC,0EAA0E;IAC1E,OAAO,CAAC,iBAAiB,CAAkC;IAC3D,OAAO,CAAC,iBAAiB,CAAkC;IAC3D,OAAO,CAAC,UAAU,CAAK;gBAEX,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC;IAUtD,GAAG,CACD,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,YAAY,EACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,IAAI;IAIP,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE;IAItD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI3B,IAAI,IAAI,MAAM;IAId,UAAU,IAAI,MAAM;IAIpB,MAAM,IAAI,MAAM;IAQhB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;IAapD;;;;;;OAMG;IACH,aAAa,CACX,KAAK,EAAE,MAAM,EAAE,EACf,CAAC,EAAE,MAAM,GACR,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAQvC;;OAEG;IACH,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAWrC;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,mBAAmB,IAAI,OAAO;IAI9B;;OAEG;IACH,OAAO,IAAI,MAAM;IAQjB;;;;;;;;OAQG;IACH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,WAAW;IAWtE;;OAEG;IACH,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAKjD;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQhC;;OAEG;IACH,MAAM,CAAC,QAAQ,IAAI,IAAI;IAOvB;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,MAAM,EAAE;CAG/B"}

package/v3/dist/kernel/hnsw-adapter.js

@@ -0,0 +1,218 @@
+/**
+ * HNSW Adapter
+ *
+ * Wraps ProgressiveHnswBackend and provides backward-compatible APIs for
+ * existing callers that use InMemoryHNSWIndex or RuvectorFlatIndex interfaces.
+ *
+ * Named indexes: patterns, qe-memory, learning, coverage
+ *
+ * @see ADR-071: HNSW Implementation Unification
+ * @module kernel/hnsw-adapter
+ */
+import { ProgressiveHnswBackend } from './progressive-hnsw-backend.js';
+/**
+ * Default configurations for each named index.
+ */
+const INDEX_DEFAULTS = {
+    'patterns': {
+        dimensions: 384,
+        M: 16,
+        efConstruction: 200,
+        efSearch: 100,
+        metric: 'cosine',
+    },
+    'qe-memory': {
+        dimensions: 384,
+        M: 16,
+        efConstruction: 200,
+        efSearch: 100,
+        metric: 'cosine',
+    },
+    'learning': {
+        dimensions: 384,
+        M: 16,
+        efConstruction: 200,
+        efSearch: 50,
+        metric: 'cosine',
+    },
+    'coverage': {
+        dimensions: 768,
+        M: 16,
+        efConstruction: 200,
+        efSearch: 100,
+        metric: 'cosine',
+    },
+};
+// ============================================================================
+// Singleton Registry
+// ============================================================================
+const registry = new Map();
+// ============================================================================
+// HnswAdapter
+// ============================================================================
+/**
+ * Adapter that wraps ProgressiveHnswBackend and provides backward-compatible
+ * APIs matching the old InMemoryHNSWIndex and RuvectorFlatIndex interfaces.
+ *
+ * This adapter bridges the gap between the new IHnswIndexProvider interface
+ * and existing callers that use string-based IDs and number[] vectors.
+ */
+export class HnswAdapter {
+    backend;
+    indexName;
+    /** Maps string keys to numeric IDs (for backward compat with old APIs) */
+    stringToNumericId = new Map();
+    numericToStringId = new Map();
+    nextAutoId = 0;
+    constructor(name, config) {
+        this.indexName = name;
+        const defaults = INDEX_DEFAULTS[name] ?? {};
+        this.backend = new ProgressiveHnswBackend({ ...defaults, ...config });
+    }
+    // ============================================================================
+    // IHnswIndexProvider implementation
+    // ============================================================================
+    add(id, vector, metadata) {
+        this.backend.add(id, vector, metadata);
+    }
+    search(query, k) {
+        return this.backend.search(query, k);
+    }
+    remove(id) {
+        return this.backend.remove(id);
+    }
+    size() {
+        return this.backend.size();
+    }
+    dimensions() {
+        return this.backend.dimensions();
+    }
+    recall() {
+        return this.backend.recall();
+    }
+    // ============================================================================
+    // Backward-compatible APIs (InMemoryHNSWIndex style: string IDs, number[])
+    // ============================================================================
+    /**
+     * Add a vector using a string ID (backward compat with InMemoryHNSWIndex).
+     *
+     * @param id - String identifier
+     * @param embedding - Vector as number[]
+     */
+    addByStringId(id, embedding) {
+        let numericId = this.stringToNumericId.get(id);
+        if (numericId !== undefined) {
+            // Update existing
+            this.backend.remove(numericId);
+        }
+        else {
+            numericId = this.nextAutoId++;
+            this.stringToNumericId.set(id, numericId);
+            this.numericToStringId.set(numericId, id);
+        }
+        this.backend.add(numericId, new Float32Array(embedding));
+    }
+    /**
+     * Search using a number[] query (backward compat with InMemoryHNSWIndex).
+     *
+     * @param query - Query vector as number[]
+     * @param k - Number of results
+     * @returns Results with string IDs and scores
+     */
+    searchByArray(query, k) {
+        const results = this.backend.search(new Float32Array(query), k);
+        return results.map((r) => ({
+            id: this.numericToStringId.get(r.id) ?? String(r.id),
+            score: r.score,
+        }));
+    }
+    /**
+     * Remove by string ID (backward compat with InMemoryHNSWIndex).
+     */
+    removeByStringId(id) {
+        const numericId = this.stringToNumericId.get(id);
+        if (numericId === undefined)
+            return false;
+        const removed = this.backend.remove(numericId);
+        if (removed) {
+            this.stringToNumericId.delete(id);
+            this.numericToStringId.delete(numericId);
+        }
+        return removed;
+    }
+    /**
+     * Clear all vectors from the index.
+     */
+    clear() {
+        this.backend.clear();
+        this.stringToNumericId.clear();
+        this.numericToStringId.clear();
+        this.nextAutoId = 0;
+    }
+    /**
+     * Check whether @ruvector/gnn is available.
+     */
+    isRuvectorAvailable() {
+        return this.backend.isRuvectorAvailable();
+    }
+    /**
+     * Get the index name.
+     */
+    getName() {
+        return this.indexName;
+    }
+    // ============================================================================
+    // Factory
+    // ============================================================================
+    /**
+     * Create or retrieve a named HNSW index.
+     *
+     * Uses a singleton registry so the same name always returns the same instance.
+     *
+     * @param name - Index name (e.g. 'patterns', 'qe-memory', 'learning', 'coverage')
+     * @param config - Optional configuration overrides
+     * @returns IHnswIndexProvider instance
+     */
+    static create(name, config) {
+        const existing = registry.get(name);
+        if (existing instanceof HnswAdapter) {
+            return existing;
+        }
+        const adapter = new HnswAdapter(name, config);
+        registry.set(name, adapter);
+        return adapter;
+    }
+    /**
+     * Get an existing named index, or undefined if not created.
+     */
+    static get(name) {
+        const existing = registry.get(name);
+        return existing instanceof HnswAdapter ? existing : undefined;
+    }
+    /**
+     * Close and remove a named index from the registry.
+     */
+    static close(name) {
+        const existing = registry.get(name);
+        if (existing instanceof HnswAdapter) {
+            existing.clear();
+        }
+        registry.delete(name);
+    }
+    /**
+     * Close all named indexes.
+     */
+    static closeAll() {
+        for (const [name] of registry) {
+            HnswAdapter.close(name);
+        }
+        registry.clear();
+    }
+    /**
+     * List all registered index names.
+     */
+    static listIndexes() {
+        return Array.from(registry.keys());
+    }
+}
+//# sourceMappingURL=hnsw-adapter.js.map

package/v3/dist/kernel/hnsw-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hnsw-adapter.js","sourceRoot":"","sources":["../../src/kernel/hnsw-adapter.ts"],"names":[],"mappings":"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"}

package/v3/dist/kernel/hnsw-index-provider.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Unified HNSW Index Provider Interface
+ *
+ * Single interface for ALL vector search operations in AQE v3.
+ * Replaces the three fragmented implementations:
+ * 1. InMemoryHNSWIndex (TypeScript HNSW)
+ * 2. RuvectorFlatIndex (@ruvector/gnn flat search)
+ * 3. QEGNNEmbeddingIndex (coverage domain)
+ *
+ * @see ADR-071: HNSW Implementation Unification
+ * @module kernel/hnsw-index-provider
+ */
+/**
+ * Result from a vector similarity search.
+ */
+export interface SearchResult {
+    /** Numeric identifier for the matched vector */
+    id: number;
+    /** Similarity score (higher = more similar, range depends on metric) */
+    score: number;
+    /** Optional metadata associated with this vector */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Configuration for an HNSW index instance.
+ */
+export interface HnswConfig {
+    /** Number of vector dimensions (e.g. 384, 768) */
+    dimensions: number;
+    /** Max connections per node in the HNSW graph (default: 16) */
+    M: number;
+    /** Build-time candidate list size (default: 200) */
+    efConstruction: number;
+    /** Query-time candidate list size (default: 100) */
+    efSearch: number;
+    /** Distance metric */
+    metric: 'cosine' | 'euclidean';
+}
+/**
+ * Default HNSW configuration matching existing AQE defaults.
+ */
+export declare const DEFAULT_HNSW_CONFIG: HnswConfig;
+/**
+ * Unified HNSW index provider interface.
+ *
+ * This is the single interface ALL callers must use for vector search.
+ * Backed by ProgressiveHnswBackend which uses @ruvector/gnn's
+ * differentiableSearch as the primary engine with brute-force fallback.
+ */
+export interface IHnswIndexProvider {
+    /**
+     * Add a vector to the index.
+     *
+     * @param id - Numeric identifier for the vector
+     * @param vector - The vector data (must match configured dimensions, or will be auto-resized)
+     * @param metadata - Optional metadata to associate with this vector
+     */
+    add(id: number, vector: Float32Array, metadata?: Record<string, unknown>): void;
+    /**
+     * Search for the k nearest neighbors of the query vector.
+     *
+     * @param query - Query vector (must match configured dimensions, or will be auto-resized)
+     * @param k - Number of neighbors to return
+     * @returns Array of SearchResult sorted by descending score
+     */
+    search(query: Float32Array, k: number): SearchResult[];
+    /**
+     * Remove a vector from the index.
+     *
+     * @param id - The numeric identifier to remove
+     * @returns true if the vector was found and removed, false otherwise
+     */
+    remove(id: number): boolean;
+    /**
+     * Get the number of vectors currently in the index.
+     */
+    size(): number;
+    /**
+     * Get the configured vector dimensions.
+     */
+    dimensions(): number;
+    /**
+     * Get the estimated recall of the index (0-1).
+     *
+     * For brute-force search this returns 1.0 (exact results).
+     * For approximate HNSW this returns an estimate based on configuration.
+     */
+    recall(): number;
+}
+//# sourceMappingURL=hnsw-index-provider.d.ts.map

package/v3/dist/kernel/hnsw-index-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hnsw-index-provider.d.ts","sourceRoot":"","sources":["../../src/kernel/hnsw-index-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,EAAE,EAAE,MAAM,CAAC;IACX,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAMD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,kDAAkD;IAClD,UAAU,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,CAAC,EAAE,MAAM,CAAC;IACV,oDAAoD;IACpD,cAAc,EAAE,MAAM,CAAC;IACvB,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,MAAM,EAAE,QAAQ,GAAG,WAAW,CAAC;CAChC;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,UAMjC,CAAC;AAMF;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;OAMG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAEhF;;;;;;OAMG;IACH,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE,CAAC;IAEvD;;;;;OAKG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAE5B;;OAEG;IACH,IAAI,IAAI,MAAM,CAAC;IAEf;;OAEG;IACH,UAAU,IAAI,MAAM,CAAC;IAErB;;;;;OAKG;IACH,MAAM,IAAI,MAAM,CAAC;CAClB"}

package/v3/dist/kernel/hnsw-index-provider.js

@@ -0,0 +1,23 @@
+/**
+ * Unified HNSW Index Provider Interface
+ *
+ * Single interface for ALL vector search operations in AQE v3.
+ * Replaces the three fragmented implementations:
+ * 1. InMemoryHNSWIndex (TypeScript HNSW)
+ * 2. RuvectorFlatIndex (@ruvector/gnn flat search)
+ * 3. QEGNNEmbeddingIndex (coverage domain)
+ *
+ * @see ADR-071: HNSW Implementation Unification
+ * @module kernel/hnsw-index-provider
+ */
+/**
+ * Default HNSW configuration matching existing AQE defaults.
+ */
+export const DEFAULT_HNSW_CONFIG = {
+    dimensions: 384,
+    M: 16,
+    efConstruction: 200,
+    efSearch: 100,
+    metric: 'cosine',
+};
+//# sourceMappingURL=hnsw-index-provider.js.map

package/v3/dist/kernel/hnsw-index-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hnsw-index-provider.js","sourceRoot":"","sources":["../../src/kernel/hnsw-index-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAsCH;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAe;IAC7C,UAAU,EAAE,GAAG;IACf,CAAC,EAAE,EAAE;IACL,cAAc,EAAE,GAAG;IACnB,QAAQ,EAAE,GAAG;IACb,MAAM,EAAE,QAAQ;CACjB,CAAC"}

package/v3/dist/kernel/progressive-hnsw-backend.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Progressive HNSW Backend
+ *
+ * Unified HNSW backend implementing IHnswIndexProvider. Uses @ruvector/gnn's
+ * differentiableSearch as the primary search engine with brute-force cosine
+ * similarity fallback when @ruvector/gnn is unavailable.
+ *
+ * Progressive loading:
+ * - Construction: instant (no vectors loaded)
+ * - First add: vectors stored in flat arrays
+ * - Search: uses @ruvector/gnn differentiableSearch for ranking, then
+ *   computes exact cosine similarity for scores
+ *
+ * Handles dimension mismatch by auto-resizing vectors (384<->768).
+ *
+ * @see ADR-071: HNSW Implementation Unification
+ * @module kernel/progressive-hnsw-backend
+ */
+import type { IHnswIndexProvider, SearchResult, HnswConfig } from './hnsw-index-provider.js';
+/**
+ * Progressive HNSW backend using @ruvector/gnn differentiableSearch.
+ *
+ * Provides a unified vector search implementation that:
+ * - Uses @ruvector/gnn for fast native search when available
+ * - Falls back to brute-force cosine similarity when unavailable
+ * - Auto-resizes dimension mismatches (384 <-> 768)
+ * - Returns 1.0 recall for brute-force, estimated recall for HNSW
+ */
+export declare class ProgressiveHnswBackend implements IHnswIndexProvider {
+    private readonly config;
+    private entries;
+    private idToIndex;
+    private hasRuvector;
+    private loaded;
+    constructor(config?: Partial<HnswConfig>);
+    /**
+     * Lazily load the @ruvector/gnn backend on first operation.
+     */
+    private ensureLoaded;
+    /**
+     * Normalize a vector to the configured dimensions, resizing if needed.
+     */
+    private normalizeVector;
+    add(id: number, vector: Float32Array, metadata?: Record<string, unknown>): void;
+    search(query: Float32Array, k: number): SearchResult[];
+    /**
+     * Brute-force cosine similarity search as fallback.
+     */
+    private bruteForcSearch;
+    remove(id: number): boolean;
+    size(): number;
+    dimensions(): number;
+    recall(): number;
+    /**
+     * Check whether @ruvector/gnn is available as the search backend.
+     */
+    isRuvectorAvailable(): boolean;
+    /**
+     * Get the current configuration.
+     */
+    getConfig(): Readonly<HnswConfig>;
+    /**
+     * Clear all vectors from the index.
+     */
+    clear(): void;
+}
+//# sourceMappingURL=progressive-hnsw-backend.d.ts.map

package/v3/dist/kernel/progressive-hnsw-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progressive-hnsw-backend.d.ts","sourceRoot":"","sources":["../../src/kernel/progressive-hnsw-backend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EACV,kBAAkB,EAClB,YAAY,EACZ,UAAU,EACX,MAAM,0BAA0B,CAAC;AAwHlC;;;;;;;;GAQG;AACH,qBAAa,sBAAuB,YAAW,kBAAkB;IAC/D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,SAAS,CAAkC;IACnD,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,MAAM,CAAkB;gBAEpB,MAAM,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC;IAIxC;;OAEG;IACH,OAAO,CAAC,YAAY;IAMpB;;OAEG;IACH,OAAO,CAAC,eAAe;IAKvB,GAAG,CACD,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,YAAY,EACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,IAAI;IAkBP,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE;IAqDtD;;OAEG;IACH,OAAO,CAAC,eAAe;IA0BvB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAiB3B,IAAI,IAAI,MAAM;IAId,UAAU,IAAI,MAAM;IAIpB,MAAM,IAAI,MAAM;IAQhB;;OAEG;IACH,mBAAmB,IAAI,OAAO;IAK9B;;OAEG;IACH,SAAS,IAAI,QAAQ,CAAC,UAAU,CAAC;IAIjC;;OAEG;IACH,KAAK,IAAI,IAAI;CAId"}