harper-kb 0.2.0

package/dist/core/search.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Knowledge Base Search
+ *
+ * Supports keyword, semantic (vector), and hybrid search modes.
+ * Applies applicability context filtering to boost/demote results.
+ * Logs all queries to the QueryLog table for analytics.
+ *
+ * All queries are scoped by kbId for multi-tenant isolation.
+ */
+import type { SearchParams, SearchResult, KnowledgeEntry, ApplicabilityContext } from '../types.ts';
+/**
+ * Search the knowledge base.
+ *
+ * @param params - Search parameters including kbId, query, mode, tags, limit, context
+ * @returns Scored and sorted search results
+ */
+export declare function search(params: SearchParams): Promise<SearchResult[]>;
+/**
+ * Filter and re-score results based on applicability context.
+ *
+ * If the caller provides their environment context, results that match get a
+ * score boost, while results that specify a different scope get a score penalty
+ * (but are NOT hidden). Context dimensions are generic key-value pairs — each
+ * KB defines its own (e.g., product version, tier, region, platform).
+ */
+export declare function filterByApplicability(results: SearchResult[], context: ApplicabilityContext): SearchResult[];
+/**
+ * List entries without search scoring.
+ *
+ * Returns entries sorted by updatedAt (newest first), with no relevance
+ * scoring. Used for browse mode where there's no search query.
+ */
+export declare function listEntries(kbId: string, tags?: string[], limit?: number): Promise<Omit<KnowledgeEntry, 'embedding'>[]>;
+//# sourceMappingURL=search.d.ts.map

package/dist/core/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/core/search.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AA8CpG;;;;;GAKG;AACH,wBAAsB,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAiC1E;AAiJD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,OAAO,EAAE,oBAAoB,GAAG,YAAY,EAAE,CAsC5G;AAgED;;;;;GAKG;AACH,wBAAsB,WAAW,CAChC,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,EAAE,EACf,KAAK,GAAE,MAAW,GAChB,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,WAAW,CAAC,EAAE,CAAC,CA2B9C"}

package/dist/core/search.js

@@ -0,0 +1,327 @@
+/**
+ * Knowledge Base Search
+ *
+ * Supports keyword, semantic (vector), and hybrid search modes.
+ * Applies applicability context filtering to boost/demote results.
+ * Logs all queries to the QueryLog table for analytics.
+ *
+ * All queries are scoped by kbId for multi-tenant isolation.
+ */
+import crypto from 'node:crypto';
+import { generateEmbedding } from "./embeddings.js";
+/** Default number of results to return */
+const DEFAULT_LIMIT = 10;
+/**
+ * Convert a Harper database record to a plain SearchResult object.
+ *
+ * Harper records use non-enumerable properties, so object spread
+ * ({...record}) produces an empty object. We must explicitly read
+ * each field.
+ */
+function toSearchResult(record, score, matchType) {
+    const entry = record;
+    return {
+        id: entry.id,
+        kbId: entry.kbId,
+        title: entry.title,
+        content: entry.content,
+        tags: entry.tags,
+        appliesTo: entry.appliesTo,
+        source: entry.source,
+        sourceUrl: entry.sourceUrl,
+        references: entry.references,
+        confidence: entry.confidence,
+        addedBy: entry.addedBy,
+        reviewedBy: entry.reviewedBy,
+        supersedesId: entry.supersedesId,
+        supersededById: entry.supersededById,
+        siblingIds: entry.siblingIds,
+        relatedIds: entry.relatedIds,
+        metadata: entry.metadata,
+        deprecated: entry.deprecated,
+        createdAt: entry.createdAt,
+        updatedAt: entry.updatedAt,
+        score,
+        matchType,
+    };
+}
+/** Score boost factor for applicability matches */
+const APPLICABILITY_BOOST = 1.2;
+/** Score penalty factor for applicability mismatches */
+const APPLICABILITY_PENALTY = 0.8;
+/**
+ * Search the knowledge base.
+ *
+ * @param params - Search parameters including kbId, query, mode, tags, limit, context
+ * @returns Scored and sorted search results
+ */
+export async function search(params) {
+    const { kbId, query, tags, limit = DEFAULT_LIMIT, context, mode = 'hybrid' } = params;
+    let results;
+    switch (mode) {
+        case 'keyword':
+            results = await keywordSearch(kbId, query, tags, limit);
+            break;
+        case 'semantic':
+            results = await semanticSearch(kbId, query, limit);
+            break;
+        case 'hybrid':
+        default:
+            results = await hybridSearch(kbId, query, tags, limit);
+            break;
+    }
+    // Apply applicability filtering (boost/demote based on context)
+    if (context) {
+        results = filterByApplicability(results, context);
+    }
+    // Re-sort by score after applicability adjustments
+    results.sort((a, b) => b.score - a.score);
+    // Trim to limit
+    results = results.slice(0, limit);
+    // Log the search query for analytics
+    await logQuery(kbId, query, context, results);
+    return results;
+}
+/**
+ * Perform keyword-based search using Harper's condition-based search.
+ */
+async function keywordSearch(kbId, query, tags, limit = DEFAULT_LIMIT) {
+    // Run the title search
+    const titleResults = await collectResults(databases.kb.KnowledgeEntry.search({
+        conditions: [
+            { attribute: 'kbId', comparator: 'equals', value: kbId },
+            { attribute: 'title', comparator: 'contains', value: query },
+            { attribute: 'deprecated', comparator: 'equals', value: false },
+        ],
+        limit: limit * 2, // Fetch extra for merging
+    }));
+    // Also search by content
+    const contentResults = await collectResults(databases.kb.KnowledgeEntry.search({
+        conditions: [
+            { attribute: 'kbId', comparator: 'equals', value: kbId },
+            { attribute: 'content', comparator: 'contains', value: query },
+            { attribute: 'deprecated', comparator: 'equals', value: false },
+        ],
+        limit: limit * 2,
+    }));
+    // Merge and deduplicate
+    const seenIds = new Set();
+    const results = [];
+    // Title matches get higher score
+    for (const entry of titleResults) {
+        const typed = entry;
+        if (typed.id && !seenIds.has(typed.id)) {
+            seenIds.add(typed.id);
+            results.push(toSearchResult(entry, 1.0, 'keyword'));
+        }
+    }
+    // Content matches get lower score
+    for (const entry of contentResults) {
+        const typed = entry;
+        if (typed.id && !seenIds.has(typed.id)) {
+            seenIds.add(typed.id);
+            results.push(toSearchResult(entry, 0.7, 'keyword'));
+        }
+    }
+    // Filter by tags if needed (post-filter since conditions are ANDed)
+    if (tags && tags.length > 0) {
+        return results.filter((r) => {
+            const entryTags = r.tags || [];
+            return tags.some((tag) => entryTags.includes(tag));
+        });
+    }
+    return results;
+}
+/**
+ * Perform semantic (vector) search using HNSW index.
+ */
+async function semanticSearch(kbId, query, limit = DEFAULT_LIMIT) {
+    let queryVector;
+    try {
+        queryVector = await generateEmbedding(query);
+    }
+    catch (error) {
+        logger?.warn?.('Semantic search failed — embedding model not available:', error.message);
+        return [];
+    }
+    const rawResults = await collectResults(databases.kb.KnowledgeEntry.search({
+        conditions: [{ attribute: 'kbId', comparator: 'equals', value: kbId }],
+        sort: { attribute: 'embedding', target: queryVector },
+        limit: limit * 2, // Fetch extra to allow for deprecated filtering
+    }));
+    const results = [];
+    for (const entry of rawResults) {
+        const typed = entry;
+        if (typed.deprecated)
+            continue; // Skip deprecated entries
+        // Calculate cosine similarity score (HNSW returns nearest first)
+        // Score decreases with position (1.0 for first result, decreasing)
+        const positionScore = 1.0 - results.length / (limit * 2);
+        results.push(toSearchResult(entry, Math.max(0.1, positionScore), 'semantic'));
+        if (results.length >= limit)
+            break;
+    }
+    return results;
+}
+/**
+ * Perform hybrid search: run both keyword and semantic, merge and deduplicate.
+ */
+async function hybridSearch(kbId, query, tags, limit = DEFAULT_LIMIT) {
+    // Run both searches in parallel
+    const [keywordResults, semanticResults] = await Promise.all([
+        keywordSearch(kbId, query, tags, limit),
+        semanticSearch(kbId, query, limit),
+    ]);
+    // Merge and deduplicate
+    const resultMap = new Map();
+    // Add keyword results
+    for (const result of keywordResults) {
+        resultMap.set(result.id, result);
+    }
+    // Merge semantic results (combine scores if entry appears in both)
+    for (const result of semanticResults) {
+        const existing = resultMap.get(result.id);
+        if (existing) {
+            // Entry found in both — combine scores and mark as hybrid
+            existing.score = ((existing.score + result.score) / 2) * 1.3; // Boost for appearing in both
+            existing.matchType = 'hybrid';
+        }
+        else {
+            resultMap.set(result.id, result);
+        }
+    }
+    const merged = Array.from(resultMap.values());
+    merged.sort((a, b) => b.score - a.score);
+    return merged.slice(0, limit);
+}
+/**
+ * Filter and re-score results based on applicability context.
+ *
+ * If the caller provides their environment context, results that match get a
+ * score boost, while results that specify a different scope get a score penalty
+ * (but are NOT hidden). Context dimensions are generic key-value pairs — each
+ * KB defines its own (e.g., product version, tier, region, platform).
+ */
+export function filterByApplicability(results, context) {
+    return results.map((result) => {
+        const appliesTo = result.appliesTo;
+        if (!appliesTo) {
+            return result;
+        }
+        let matchCount = 0;
+        let mismatchCount = 0;
+        let totalFields = 0;
+        for (const key of Object.keys(appliesTo)) {
+            if (context[key] === undefined)
+                continue;
+            totalFields++;
+            const matches = isVersionRange(appliesTo[key])
+                ? versionMatches(context[key], appliesTo[key])
+                : context[key] === appliesTo[key];
+            if (matches) {
+                matchCount++;
+            }
+            else {
+                mismatchCount++;
+            }
+        }
+        if (totalFields === 0) {
+            return result;
+        }
+        let adjustedScore = result.score;
+        if (matchCount > 0) {
+            adjustedScore *= APPLICABILITY_BOOST;
+        }
+        if (mismatchCount > 0) {
+            adjustedScore *= APPLICABILITY_PENALTY;
+        }
+        return { ...result, score: adjustedScore };
+    });
+}
+/**
+ * Detect whether a value looks like a semver range (starts with a range prefix).
+ */
+function isVersionRange(value) {
+    return /^[>=<~^]/.test(value);
+}
+/**
+ * Simple version matching.
+ * Supports exact match and basic semver range prefixes (>=, <=, ~, ^).
+ * For production use, consider a proper semver library.
+ */
+function versionMatches(actual, required) {
+    // Strip common prefixes for comparison
+    const cleanActual = actual.replace(/^[v=]/, '');
+    const cleanRequired = required.replace(/^[v=]/, '');
+    // Exact match
+    if (cleanActual === cleanRequired)
+        return true;
+    // Range prefix checks (simplified)
+    if (required.startsWith('>=')) {
+        return cleanActual >= required.slice(2);
+    }
+    if (required.startsWith('<=')) {
+        return cleanActual <= required.slice(2);
+    }
+    // For ~ and ^ ranges, just check major.minor match
+    if (required.startsWith('~') || required.startsWith('^')) {
+        const reqParts = required.slice(1).split('.');
+        const actParts = cleanActual.split('.');
+        return reqParts[0] === actParts[0] && (reqParts.length < 2 || reqParts[1] === actParts[1]);
+    }
+    return false;
+}
+/**
+ * Log a search query to the QueryLog table for analytics.
+ */
+async function logQuery(kbId, query, context, results) {
+    try {
+        await databases.kb.QueryLog.put({
+            id: crypto.randomUUID(),
+            kbId,
+            query,
+            context: context || null,
+            resultCount: results.length,
+            topResultId: results.length > 0 ? results[0].id : null,
+        });
+    }
+    catch (error) {
+        // Don't fail the search if logging fails
+        logger?.warn?.('Failed to log search query:', error.message);
+    }
+}
+/**
+ * List entries without search scoring.
+ *
+ * Returns entries sorted by updatedAt (newest first), with no relevance
+ * scoring. Used for browse mode where there's no search query.
+ */
+export async function listEntries(kbId, tags, limit = 30) {
+    const { stripEmbedding } = await import("./entries.js");
+    const conditions = [
+        { attribute: 'kbId', comparator: 'equals', value: kbId },
+        { attribute: 'deprecated', comparator: 'equals', value: false },
+    ];
+    if (tags && tags.length > 0) {
+        for (const tag of tags) {
+            conditions.push({ attribute: 'tags', comparator: 'contains', value: tag });
+        }
+    }
+    const records = await collectResults(databases.kb.KnowledgeEntry.search({
+        conditions,
+        sort: { attribute: 'updatedAt', descending: true },
+        limit,
+    }));
+    return records.map((record) => stripEmbedding(record));
+}
+/**
+ * Collect all results from an async iterable into an array.
+ */
+async function collectResults(iterable) {
+    const results = [];
+    for await (const item of iterable) {
+        results.push(item);
+    }
+    return results;
+}
+//# sourceMappingURL=search.js.map

package/dist/core/search.js.map

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

package/dist/core/tags.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Tag Management
+ *
+ * Manages knowledge base tags, including listing and synchronizing
+ * tag counts when entries are created, updated, or deleted.
+ *
+ * Tags are scoped per knowledge base. The tag ID is a composite key
+ * of `${kbId}:${tagName}` to allow the same tag name across different KBs.
+ */
+import type { KnowledgeTag } from '../types.ts';
+/**
+ * List knowledge tags for a specific knowledge base.
+ *
+ * @param kbId - Knowledge base identifier
+ * @param limit - Maximum number of tags to return (default 500)
+ * @returns Tags from the KnowledgeTag table scoped to this KB
+ */
+export declare function listTags(kbId: string, limit?: number): Promise<KnowledgeTag[]>;
+/**
+ * Get a single tag by name within a knowledge base.
+ *
+ * @param kbId - Knowledge base identifier
+ * @param tagName - Tag name
+ * @returns The tag record, or null if not found
+ */
+export declare function getTag(kbId: string, tagName: string): Promise<KnowledgeTag | null>;
+/**
+ * Synchronize tag counts when entries are created, updated, or deleted.
+ *
+ * For tags added (in newTags but not in previousTags), increment entryCount
+ * or create the tag with count 1. For tags removed (in previousTags but not
+ * in newTags), decrement entryCount.
+ *
+ * @param kbId - Knowledge base identifier
+ * @param newTags - Tags on the entry after the change
+ * @param previousTags - Tags on the entry before the change (empty for new entries)
+ */
+export declare function syncTags(kbId: string, newTags: string[], previousTags?: string[]): Promise<void>;
+//# sourceMappingURL=tags.d.ts.map

package/dist/core/tags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tags.d.ts","sourceRoot":"","sources":["../../src/core/tags.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAShD;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CASjF;AAED;;;;;;GAMG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAGxF;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA2CtG"}

package/dist/core/tags.js

@@ -0,0 +1,97 @@
+/**
+ * Tag Management
+ *
+ * Manages knowledge base tags, including listing and synchronizing
+ * tag counts when entries are created, updated, or deleted.
+ *
+ * Tags are scoped per knowledge base. The tag ID is a composite key
+ * of `${kbId}:${tagName}` to allow the same tag name across different KBs.
+ */
+/**
+ * Build a composite tag ID from kbId and tag name.
+ */
+function tagId(kbId, tagName) {
+    return `${kbId}:${tagName}`;
+}
+/**
+ * List knowledge tags for a specific knowledge base.
+ *
+ * @param kbId - Knowledge base identifier
+ * @param limit - Maximum number of tags to return (default 500)
+ * @returns Tags from the KnowledgeTag table scoped to this KB
+ */
+export async function listTags(kbId, limit = 500) {
+    const results = [];
+    for await (const tag of databases.kb.KnowledgeTag.search({
+        conditions: [{ attribute: 'kbId', comparator: 'equals', value: kbId }],
+        limit,
+    })) {
+        results.push(tag);
+    }
+    return results;
+}
+/**
+ * Get a single tag by name within a knowledge base.
+ *
+ * @param kbId - Knowledge base identifier
+ * @param tagName - Tag name
+ * @returns The tag record, or null if not found
+ */
+export async function getTag(kbId, tagName) {
+    const tag = await databases.kb.KnowledgeTag.get(tagId(kbId, tagName));
+    return tag;
+}
+/**
+ * Synchronize tag counts when entries are created, updated, or deleted.
+ *
+ * For tags added (in newTags but not in previousTags), increment entryCount
+ * or create the tag with count 1. For tags removed (in previousTags but not
+ * in newTags), decrement entryCount.
+ *
+ * @param kbId - Knowledge base identifier
+ * @param newTags - Tags on the entry after the change
+ * @param previousTags - Tags on the entry before the change (empty for new entries)
+ */
+export async function syncTags(kbId, newTags, previousTags) {
+    const prev = new Set(previousTags || []);
+    const next = new Set(newTags);
+    // Tags that were added
+    const added = newTags.filter((tag) => !prev.has(tag));
+    // Tags that were removed
+    const removed = (previousTags || []).filter((tag) => !next.has(tag));
+    // Increment counts for added tags
+    for (const tagName of added) {
+        const id = tagId(kbId, tagName);
+        const existing = await databases.kb.KnowledgeTag.get(id);
+        if (existing) {
+            await databases.kb.KnowledgeTag.put({
+                ...existing,
+                id,
+                kbId,
+                entryCount: (existing.entryCount || 0) + 1,
+            });
+        }
+        else {
+            await databases.kb.KnowledgeTag.put({
+                id,
+                kbId,
+                entryCount: 1,
+            });
+        }
+    }
+    // Decrement counts for removed tags
+    for (const tagName of removed) {
+        const id = tagId(kbId, tagName);
+        const existing = await databases.kb.KnowledgeTag.get(id);
+        if (existing) {
+            const currentCount = existing.entryCount || 0;
+            await databases.kb.KnowledgeTag.put({
+                ...existing,
+                id,
+                kbId,
+                entryCount: Math.max(0, currentCount - 1),
+            });
+        }
+    }
+}
+//# sourceMappingURL=tags.js.map

package/dist/core/tags.js.map

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

package/dist/core/triage.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Triage Queue Management
+ *
+ * Handles the intake queue for new knowledge submissions from webhooks
+ * and other sources. Items go through pending -> processing -> accepted/dismissed.
+ *
+ * All operations are scoped by kbId for multi-tenant isolation.
+ */
+import type { TriageItem, TriageAction, TriageProcessOptions } from '../types.ts';
+/**
+ * Submit a new item to the triage queue.
+ *
+ * @param kbId - Knowledge base identifier
+ * @param source - Source identifier (e.g., "github-webhook", "slack-bot", "manual")
+ * @param summary - Brief summary of the knowledge to triage
+ * @param rawPayload - Original raw payload from the source
+ * @param sourceId - Optional deduplication key from the source system
+ * @returns The created triage item
+ */
+export declare function submitTriage(kbId: string, source: string, summary: string, rawPayload?: unknown, sourceId?: string): Promise<TriageItem>;
+/**
+ * Find a triage item by its source-specific ID for deduplication.
+ *
+ * @param kbId - Knowledge base identifier
+ * @param sourceId - The source-specific identifier
+ * @returns The matching triage item, or null if not found
+ */
+export declare function findBySourceId(kbId: string, sourceId: string): Promise<TriageItem | null>;
+/**
+ * Process a triage item with the given action.
+ *
+ * - "accepted": Optionally creates a new knowledge entry from provided data
+ * - "dismissed": Marks the item as dismissed
+ * - "linked": Links the triage item to an existing knowledge entry
+ *
+ * @param id - Triage item ID
+ * @param action - Action to take
+ * @param processedBy - Who processed this item
+ * @param options - Additional options (entry data for accept, linked entry ID)
+ * @returns The updated triage item
+ * @throws Error if the triage item does not exist
+ */
+export declare function processTriage(id: string, action: TriageAction, processedBy: string, options?: TriageProcessOptions): Promise<TriageItem>;
+/**
+ * List pending triage items for a specific knowledge base.
+ *
+ * @param kbId - Knowledge base identifier
+ * @param limit - Maximum number of items to return (default 200)
+ * @returns Array of triage items with status "pending"
+ */
+export declare function listPending(kbId: string, limit?: number): Promise<TriageItem[]>;
+/**
+ * Dismiss a triage item.
+ *
+ * Convenience method that calls processTriage with action "dismissed".
+ *
+ * @param id - Triage item ID
+ * @param processedBy - Who dismissed this item
+ */
+export declare function dismissTriage(id: string, processedBy: string): Promise<void>;
+//# sourceMappingURL=triage.d.ts.map

package/dist/core/triage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"triage.d.ts","sourceRoot":"","sources":["../../src/core/triage.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,oBAAoB,EAAuB,MAAM,aAAa,CAAC;AAEvG;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CACjC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,OAAO,EACpB,QAAQ,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,CAAC,CAgBrB;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAW/F;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,aAAa,CAClC,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,YAAY,EACpB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAAC,UAAU,CAAC,CAyCrB;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAYlF;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAElF"}