@iflow-mcp/jkheadley-instar 0.26.2

package/dist/knowledge/TreeTraversal.d.ts

@@ -0,0 +1,93 @@
+/**
+ * TreeTraversal — Source gathering and content extraction with tiered caching.
+ *
+ * Walks the tree's relevant nodes, reads their sources (files, memory, probes,
+ * etc.), and returns content fragments. Handles per-source timeouts, token
+ * truncation, and cache management.
+ *
+ * Born from: PROP-XXX (Self-Knowledge Tree for Instar Agents)
+ */
+import type { SelfKnowledgeNode, SelfKnowledgeFragment, SourceError, CacheTier, CacheStats } from './types.js';
+import type { ProbeRegistry } from './ProbeRegistry.js';
+import type { IntegrityManager } from './IntegrityManager.js';
+interface MemorySearchable {
+    search(query: string, options?: {
+        limit?: number;
+    }): Array<{
+        text?: string;
+        content?: string;
+        source?: string;
+    }>;
+}
+interface DecisionJournalQueryable {
+    query(options?: {
+        limit?: number;
+    }): Array<{
+        decision?: string;
+        dispatchDecision?: string;
+        reason?: string;
+        timestamp?: string;
+    }>;
+}
+export interface TraversalDependencies {
+    projectDir: string;
+    stateDir: string;
+    probeRegistry: ProbeRegistry;
+    memoryIndex?: MemorySearchable;
+    knowledgeManager?: {
+        getCatalog?(): {
+            sources: Array<{
+                title: string;
+                summary: string;
+            }>;
+        };
+    };
+    decisionJournal?: DecisionJournalQueryable;
+    integrityManager?: IntegrityManager;
+}
+export declare class TreeTraversal {
+    private cache;
+    private stats;
+    private maxCacheSize;
+    private deps;
+    constructor(deps: TraversalDependencies);
+    /**
+     * Gather content for a set of nodes. Returns fragments and any errors.
+     */
+    gather(nodes: SelfKnowledgeNode[], layerScores: Record<string, number>, options?: {
+        publicOnly?: boolean;
+    }): Promise<{
+        fragments: SelfKnowledgeFragment[];
+        errors: SourceError[];
+    }>;
+    /**
+     * Get cache statistics.
+     */
+    cacheStats(): CacheStats;
+    /**
+     * Invalidate cache entries for a specific tier.
+     */
+    invalidateTier(tier: CacheTier): void;
+    /**
+     * Invalidate all cache entries.
+     */
+    invalidateAll(): void;
+    private gatherNode;
+    private resolveSource;
+    private resolveSourceInner;
+    private readFile;
+    private readFileSection;
+    private readJsonFields;
+    private readStateFile;
+    private searchMemory;
+    private searchKnowledge;
+    private executeProbe;
+    private queryDecisionJournal;
+    private resolvePath;
+    private getNestedField;
+    private getFromCache;
+    private putInCache;
+    private sourceTimeout;
+}
+export {};
+//# sourceMappingURL=TreeTraversal.d.ts.map

package/dist/knowledge/TreeTraversal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TreeTraversal.d.ts","sourceRoot":"","sources":["../../src/knowledge/TreeTraversal.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EACV,iBAAiB,EAEjB,qBAAqB,EACrB,WAAW,EACX,SAAS,EAET,UAAU,EACX,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAM9D,UAAU,gBAAgB;IACxB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,KAAK,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClH;AAED,UAAU,wBAAwB;IAChC,KAAK,CAAC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,KAAK,CAAC;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnI;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,aAAa,CAAC;IAC7B,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,gBAAgB,CAAC,EAAE;QAAE,UAAU,CAAC,IAAI;YAAE,OAAO,EAAE,KAAK,CAAC;gBAAE,KAAK,EAAE,MAAM,CAAC;gBAAC,OAAO,EAAE,MAAM,CAAA;aAAE,CAAC,CAAA;SAAE,CAAA;KAAE,CAAC;IAC7F,eAAe,CAAC,EAAE,wBAAwB,CAAC;IAC3C,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACrC;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAyC;IACtD,OAAO,CAAC,KAAK,CAAwC;IACrD,OAAO,CAAC,YAAY,CAAO;IAC3B,OAAO,CAAC,IAAI,CAAwB;gBAExB,IAAI,EAAE,qBAAqB;IAIvC;;OAEG;IACG,MAAM,CACV,KAAK,EAAE,iBAAiB,EAAE,EAC1B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACnC,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,GACjC,OAAO,CAAC;QAAE,SAAS,EAAE,qBAAqB,EAAE,CAAC;QAAC,MAAM,EAAE,WAAW,EAAE,CAAA;KAAE,CAAC;IAoBzE;;OAEG;IACH,UAAU,IAAI,UAAU;IAWxB;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IASrC;;OAEG;IACH,aAAa,IAAI,IAAI;YAMP,UAAU;YA4EV,aAAa;YAWb,kBAAkB;IAoChC,OAAO,CAAC,QAAQ;IAqBhB,OAAO,CAAC,eAAe;IAyBvB,OAAO,CAAC,cAAc;IAmBtB,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,eAAe;YAsBT,YAAY;IAS1B,OAAO,CAAC,oBAAoB;IAiB5B,OAAO,CAAC,WAAW;IAkBnB,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,YAAY;IAmBpB,OAAO,CAAC,UAAU;IAiBlB,OAAO,CAAC,aAAa;CAOtB"}

package/dist/knowledge/TreeTraversal.js

@@ -0,0 +1,359 @@
+/**
+ * TreeTraversal — Source gathering and content extraction with tiered caching.
+ *
+ * Walks the tree's relevant nodes, reads their sources (files, memory, probes,
+ * etc.), and returns content fragments. Handles per-source timeouts, token
+ * truncation, and cache management.
+ *
+ * Born from: PROP-XXX (Self-Knowledge Tree for Instar Agents)
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { CACHE_TTL_MS, layerToTier } from './types.js';
+const DEFAULT_SOURCE_TIMEOUT_MS = 5_000;
+const CHARS_PER_TOKEN = 4; // rough estimate
+export class TreeTraversal {
+    cache = new Map();
+    stats = { hits: 0, misses: 0, evictions: 0 };
+    maxCacheSize = 200;
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /**
+     * Gather content for a set of nodes. Returns fragments and any errors.
+     */
+    async gather(nodes, layerScores, options) {
+        const fragments = [];
+        const errors = [];
+        // Process nodes in parallel (each node gathers its sources)
+        const results = await Promise.allSettled(nodes.map(node => this.gatherNode(node, layerScores, options)));
+        for (const result of results) {
+            if (result.status === 'fulfilled') {
+                fragments.push(...result.value.fragments);
+                errors.push(...result.value.errors);
+            }
+            // Promise.allSettled never rejects, but guard anyway
+        }
+        return { fragments, errors };
+    }
+    /**
+     * Get cache statistics.
+     */
+    cacheStats() {
+        const total = this.stats.hits + this.stats.misses;
+        return {
+            hits: this.stats.hits,
+            misses: this.stats.misses,
+            evictions: this.stats.evictions,
+            size: this.cache.size,
+            hitRate: total > 0 ? this.stats.hits / total : 0,
+        };
+    }
+    /**
+     * Invalidate cache entries for a specific tier.
+     */
+    invalidateTier(tier) {
+        for (const [key, entry] of this.cache) {
+            if (entry.tier === tier) {
+                this.cache.delete(key);
+                this.stats.evictions++;
+            }
+        }
+    }
+    /**
+     * Invalidate all cache entries.
+     */
+    invalidateAll() {
+        const size = this.cache.size;
+        this.cache.clear();
+        this.stats.evictions += size;
+    }
+    async gatherNode(node, layerScores, options) {
+        const fragments = [];
+        const errors = [];
+        // Skip internal nodes when publicOnly
+        if (options?.publicOnly && node.sensitivity === 'internal') {
+            return { fragments, errors };
+        }
+        const layerId = node.id.split('.')[0];
+        const relevance = layerScores[layerId] ?? 0;
+        // Check cache first
+        const cached = this.getFromCache(node.id, layerId);
+        if (cached !== null) {
+            fragments.push({
+                layerId,
+                nodeId: node.id,
+                relevance,
+                content: cached,
+                cached: true,
+                sensitivity: node.sensitivity,
+            });
+            return { fragments, errors };
+        }
+        // Gather content from all sources
+        const contents = [];
+        for (const source of node.sources) {
+            try {
+                const content = await this.resolveSource(source, node);
+                if (content) {
+                    contents.push(content);
+                }
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                errors.push({
+                    nodeId: node.id,
+                    sourceType: source.type,
+                    error: message,
+                    elapsedMs: 0,
+                });
+            }
+        }
+        if (contents.length === 0) {
+            return { fragments, errors };
+        }
+        // Combine, strip HTML comments (prevent hidden injection), and truncate
+        let combined = contents.join('\n\n');
+        combined = combined.replace(/<!--[\s\S]*?-->/g, '');
+        const maxChars = node.maxTokens * CHARS_PER_TOKEN;
+        if (combined.length > maxChars) {
+            combined = combined.slice(0, maxChars) + '\n[truncated]';
+        }
+        // Cache the result
+        this.putInCache(node.id, layerId, combined);
+        fragments.push({
+            layerId,
+            nodeId: node.id,
+            relevance,
+            content: combined,
+            cached: false,
+            sensitivity: node.sensitivity,
+        });
+        return { fragments, errors };
+    }
+    async resolveSource(source, node) {
+        // Wrap in timeout
+        return Promise.race([
+            this.resolveSourceInner(source, node),
+            this.sourceTimeout(DEFAULT_SOURCE_TIMEOUT_MS, node.id, source.type),
+        ]);
+    }
+    async resolveSourceInner(source, _node) {
+        switch (source.type) {
+            case 'file':
+                return this.readFile(source.path);
+            case 'file_section':
+                return this.readFileSection(source.path, source.section);
+            case 'json_file':
+                return this.readJsonFields(source.path, source.fields);
+            case 'state_file':
+                return this.readStateFile(source.key);
+            case 'memory_search':
+                return this.searchMemory(source.query, source.topK);
+            case 'knowledge_search':
+                return this.searchKnowledge(source.query, source.topK);
+            case 'probe':
+                return this.executeProbe(source.name, source.args);
+            case 'decision_journal':
+                return this.queryDecisionJournal(source.query, source.limit);
+            default:
+                return null;
+        }
+    }
+    // ── Source resolvers ───────────────────────────────────────────────
+    readFile(filePath) {
+        const resolved = this.resolvePath(filePath);
+        if (!resolved)
+            return null;
+        try {
+            // Verify integrity if IntegrityManager is available
+            if (this.deps.integrityManager) {
+                const result = this.deps.integrityManager.verify(resolved);
+                if (!result.valid) {
+                    // Fail closed — throw to surface as a SourceError
+                    throw new Error(`Integrity verification failed: ${result.reason}`);
+                }
+            }
+            return fs.readFileSync(resolved, 'utf-8');
+        }
+        catch (err) {
+            if (err instanceof Error && err.message.startsWith('Integrity verification failed')) {
+                throw err; // Re-throw integrity errors so they appear in SourceError[]
+            }
+            return null;
+        }
+    }
+    readFileSection(filePath, section) {
+        const content = this.readFile(filePath);
+        if (!content)
+            return null;
+        // Find section by markdown heading
+        const pattern = new RegExp(`^#{1,6}\\s+${section.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}\\s*$`, 'im');
+        const match = content.match(pattern);
+        if (!match || match.index === undefined)
+            return null;
+        const start = match.index;
+        const headingLevel = match[0].match(/^#+/)[0].length;
+        // Find the next heading at same or higher level
+        const rest = content.slice(start + match[0].length);
+        const nextHeading = rest.match(new RegExp(`^#{1,${headingLevel}}\\s`, 'm'));
+        const end = nextHeading?.index
+            ? start + match[0].length + nextHeading.index
+            : content.length;
+        return content.slice(start, end).trim();
+    }
+    readJsonFields(filePath, fields) {
+        const content = this.readFile(filePath);
+        if (!content)
+            return null;
+        try {
+            const data = JSON.parse(content);
+            const result = {};
+            for (const field of fields) {
+                const value = this.getNestedField(data, field);
+                if (value !== undefined) {
+                    result[field] = value;
+                }
+            }
+            return JSON.stringify(result, null, 2);
+        }
+        catch {
+            return null;
+        }
+    }
+    readStateFile(key) {
+        const filePath = path.join(this.deps.stateDir, `${key}.json`);
+        try {
+            return fs.readFileSync(filePath, 'utf-8');
+        }
+        catch {
+            return null;
+        }
+    }
+    searchMemory(query, topK) {
+        if (!this.deps.memoryIndex)
+            return null;
+        try {
+            const results = this.deps.memoryIndex.search(query, { limit: topK });
+            if (results.length === 0)
+                return null;
+            return results
+                .map((r, i) => `[${i + 1}] ${r.text ?? r.content ?? ''} (${r.source ?? 'unknown'})`)
+                .join('\n');
+        }
+        catch {
+            return null;
+        }
+    }
+    searchKnowledge(query, topK) {
+        // KnowledgeManager doesn't have search — it uses MemoryIndex
+        // Return catalog entries that might be relevant
+        if (!this.deps.knowledgeManager?.getCatalog)
+            return null;
+        try {
+            const catalog = this.deps.knowledgeManager.getCatalog();
+            const lower = query.toLowerCase();
+            const relevant = catalog.sources
+                .filter(s => s.title.toLowerCase().includes(lower) || s.summary.toLowerCase().includes(lower))
+                .slice(0, topK);
+            if (relevant.length === 0)
+                return null;
+            return relevant
+                .map(s => `- ${s.title}: ${s.summary}`)
+                .join('\n');
+        }
+        catch {
+            return null;
+        }
+    }
+    async executeProbe(name, args) {
+        try {
+            const result = await this.deps.probeRegistry.execute(name, args);
+            return result.content;
+        }
+        catch {
+            return null;
+        }
+    }
+    queryDecisionJournal(query, limit) {
+        if (!this.deps.decisionJournal)
+            return null;
+        try {
+            const entries = this.deps.decisionJournal.query({ limit });
+            if (entries.length === 0)
+                return null;
+            return entries
+                .map(e => `[${e.timestamp}] ${e.dispatchDecision ?? e.decision}: ${e.reason ?? ''}`)
+                .join('\n');
+        }
+        catch {
+            return null;
+        }
+    }
+    // ── Path resolution & security ─────────────────────────────────────
+    resolvePath(filePath) {
+        // Resolve relative to project dir
+        const resolved = path.resolve(this.deps.projectDir, filePath);
+        // Security: prevent path traversal outside project
+        if (!resolved.startsWith(this.deps.projectDir) && !resolved.startsWith(this.deps.stateDir)) {
+            return null;
+        }
+        // Reject paths to sensitive files
+        const basename = path.basename(resolved).toLowerCase();
+        if (basename.includes('.env') || basename.includes('secret') || basename.includes('credential')) {
+            return null;
+        }
+        return resolved;
+    }
+    getNestedField(obj, field) {
+        const parts = field.split('.');
+        let current = obj;
+        for (const part of parts) {
+            if (current === null || current === undefined || typeof current !== 'object')
+                return undefined;
+            current = current[part];
+        }
+        return current;
+    }
+    // ── Caching ────────────────────────────────────────────────────────
+    getFromCache(nodeId, layerId) {
+        const entry = this.cache.get(nodeId);
+        if (!entry) {
+            this.stats.misses++;
+            return null;
+        }
+        const tier = layerToTier(layerId);
+        const ttl = CACHE_TTL_MS[tier];
+        if (Date.now() - entry.createdAt > ttl) {
+            this.cache.delete(nodeId);
+            this.stats.misses++;
+            return null;
+        }
+        this.stats.hits++;
+        return entry.value;
+    }
+    putInCache(nodeId, layerId, content) {
+        // Evict oldest if at capacity
+        if (this.cache.size >= this.maxCacheSize) {
+            const oldest = this.cache.keys().next().value;
+            if (oldest) {
+                this.cache.delete(oldest);
+                this.stats.evictions++;
+            }
+        }
+        this.cache.set(nodeId, {
+            value: content,
+            createdAt: Date.now(),
+            tier: layerToTier(layerId),
+        });
+    }
+    sourceTimeout(ms, nodeId, sourceType) {
+        return new Promise((_, reject) => {
+            setTimeout(() => {
+                reject(new Error(`Source ${sourceType} for ${nodeId} timed out after ${ms}ms`));
+            }, ms);
+        });
+    }
+}
+//# sourceMappingURL=TreeTraversal.js.map

package/dist/knowledge/TreeTraversal.js.map

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

package/dist/knowledge/TreeTriage.d.ts

@@ -0,0 +1,80 @@
+/**
+ * TreeTriage — Two-stage relevance scoring for self-knowledge queries.
+ *
+ * Stage 1: Layer-level scoring (which broad categories are relevant?)
+ * Stage 2: Node-level scoring (which specific nodes within those layers?)
+ *
+ * Primary: Rule-based keyword matching (fast, zero token cost).
+ * Fallback: Haiku LLM call for ambiguous queries where rules return low confidence.
+ *
+ * Born from: PROP-XXX (Self-Knowledge Tree for Instar Agents)
+ * Updated: Phase 0 — Two-stage triage for per-node loading
+ */
+import type { IntelligenceProvider } from '../core/types.js';
+import type { SelfKnowledgeLayer, SelfKnowledgeNode, TriageResult } from './types.js';
+/**
+ * Two-stage relevance scoring for self-knowledge queries.
+ *
+ * Stage 1: Score layers (broad categories)
+ * Stage 2: Score nodes within relevant layers (specific topics)
+ */
+export declare class TreeTriage {
+    private intelligence;
+    private threshold;
+    private nodeThreshold;
+    constructor(intelligence: IntelligenceProvider | null, threshold?: number);
+    get relevanceThreshold(): number;
+    /**
+     * Sanitize query input — prevent injection and enforce limits.
+     */
+    private sanitizeQuery;
+    /**
+     * Two-stage triage: score layers, then score nodes within relevant layers.
+     *
+     * Intelligence-first: LLM is the primary path for accurate semantic matching.
+     * Rule-based keyword matching is the fallback ONLY when LLM is unavailable.
+     *
+     * Rationale: String matching silently fails on synonyms, typos, and natural
+     * language phrasing. A lightweight model (Haiku) catches what rules miss.
+     * "Efficient" means a fast model, not regex.
+     */
+    triage(query: string, layers: SelfKnowledgeLayer[]): Promise<TriageResult>;
+    /**
+     * Filter layers by triage scores, returning those above threshold.
+     */
+    filterRelevantLayers(layers: SelfKnowledgeLayer[], scores: Record<string, number>): SelfKnowledgeLayer[];
+    /**
+     * Filter nodes by node-level scores, returning those above node threshold.
+     * Nodes with alwaysInclude are always returned regardless of score.
+     */
+    filterRelevantNodes(nodes: SelfKnowledgeNode[], nodeScores: Record<string, number>): SelfKnowledgeNode[];
+    /**
+     * Score individual nodes within the given layers using keyword matching.
+     * Returns a map of nodeId → relevance score (0.0-1.0).
+     */
+    private scoreNodes;
+    /**
+     * Validate that a set of node IDs are all known in the tree config.
+     * Returns only IDs that exist in the provided layers.
+     */
+    validateNodeIds(nodeIds: string[], layers: SelfKnowledgeLayer[]): string[];
+    /**
+     * Rule-based fallback: combines layer keywords + node keywords + node boost.
+     * Used ONLY when LLM intelligence is unavailable.
+     */
+    private ruleBasedFallback;
+    /**
+     * LLM-powered node-level triage within relevant layers.
+     * Single call to score which specific nodes are relevant to the query.
+     */
+    private llmNodeTriage;
+    /**
+     * Parse LLM response for node-level scores.
+     * Falls back to keyword matching (not uniform scores) when LLM output is unparseable.
+     */
+    private parseNodeTriageResponse;
+    private llmTriage;
+    private parseTriageResponse;
+    private ruleBasedLayerTriage;
+}
+//# sourceMappingURL=TreeTriage.d.ts.map

package/dist/knowledge/TreeTriage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TreeTriage.d.ts","sourceRoot":"","sources":["../../src/knowledge/TreeTriage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAyFtF;;;;;GAKG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,YAAY,CAA8B;IAClD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,aAAa,CAAS;gBAElB,YAAY,EAAE,oBAAoB,GAAG,IAAI,EAAE,SAAS,CAAC,EAAE,MAAM;IAMzE,IAAI,kBAAkB,IAAI,MAAM,CAE/B;IAED;;OAEG;IACH,OAAO,CAAC,aAAa;IAUrB;;;;;;;;;OASG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC;IAwDhF;;OAEG;IACH,oBAAoB,CAClB,MAAM,EAAE,kBAAkB,EAAE,EAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,kBAAkB,EAAE;IAIvB;;;OAGG;IACH,mBAAmB,CACjB,KAAK,EAAE,iBAAiB,EAAE,EAC1B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACjC,iBAAiB,EAAE;IAOtB;;;OAGG;IACH,OAAO,CAAC,UAAU;IAkDlB;;;OAGG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,EAAE;IAU1E;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAuCzB;;;OAGG;YACW,aAAa;IA8B3B;;;OAGG;IACH,OAAO,CAAC,uBAAuB;YAkCjB,SAAS;IA6BvB,OAAO,CAAC,mBAAmB;IA4B3B,OAAO,CAAC,oBAAoB;CA2B7B"}