@iflow-mcp/jkheadley-instar 0.26.2

package/dist/core/DeferredDispatchTracker.js.map

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

package/dist/core/DiscoveryEvaluator.d.ts

@@ -0,0 +1,131 @@
+/**
+ * DiscoveryEvaluator — LLM-powered context evaluator for feature discovery.
+ *
+ * Part of the Consent & Discovery Framework (Phase 3: Context Evaluator).
+ *
+ * Architecture:
+ *   - Input sanitization: receives topic categories, not raw user text
+ *   - Pre-filtering: excludes ineligible features before LLM call
+ *   - Haiku-class LLM evaluation with structural prompt delimiters
+ *   - Output validation: featureId must exist in eligible set
+ *   - Rate limiting: max calls/session, min interval, result caching
+ *   - Fail-open: timeout/error → no surfacing, pull path unaffected
+ *
+ * The evaluator itself is a network-tier processing activity in the
+ * feature registry (it calls an external LLM API).
+ */
+import type { IntelligenceProvider } from './types.js';
+import type { FeatureRegistry, FeatureCategory, ConsentTier } from './FeatureRegistry.js';
+/** Sanitized conversation context — NO raw user text */
+export interface DiscoveryContext {
+    /** Categorical label, not free text */
+    topicCategory: string;
+    /** High-level intent classification */
+    conversationIntent: 'debugging' | 'configuring' | 'exploring' | 'building' | 'asking' | 'monitoring' | 'unknown';
+    /** Structured problem labels, not raw error data */
+    problemCategories: string[];
+    /** User's autonomy profile name */
+    autonomyProfile: string;
+    /** Features already enabled (by ID) */
+    enabledFeatures: string[];
+    /** User ID for state lookups */
+    userId?: string;
+}
+/** Subset of FeatureDefinition sent to the evaluator */
+export interface EligibleFeature {
+    id: string;
+    name: string;
+    category: FeatureCategory;
+    oneLiner: string;
+    consentTier: ConsentTier;
+    triggerConditions: string[];
+}
+/** Single feature surfacing recommendation */
+export interface SurfacingRecommendation {
+    featureId: string;
+    surfaceAs: 'awareness' | 'suggestion' | 'prompt';
+    reasoning: string;
+    messageForAgent: string;
+}
+/** Result of context evaluation */
+export interface DiscoveryEvaluation {
+    /** The feature to surface, if any */
+    recommendation: SurfacingRecommendation | null;
+    /** Whether this was from cache */
+    cached: boolean;
+    /** Whether the evaluator was rate-limited (returned empty) */
+    rateLimited: boolean;
+    /** Number of eligible features considered */
+    eligibleCount: number;
+    /** Error message if evaluation failed (fail-open → no recommendation) */
+    error?: string;
+}
+/** Rate limiting and cost control configuration */
+export interface EvaluatorLimits {
+    /** Max evaluations per session (default: 3) */
+    maxCallsPerSession: number;
+    /** Minimum interval between evaluations in ms (default: 300000 = 5min) */
+    minIntervalMs: number;
+    /** Cache TTL in ms — results cached by topicCategory (default: 600000 = 10min) */
+    resultCacheTtlMs: number;
+    /** Hard timeout for LLM call in ms (default: 5000) */
+    timeoutMs: number;
+    /** Max features to send to evaluator (default: 10) */
+    maxFeaturesPerEval: number;
+}
+export declare class DiscoveryEvaluator {
+    private registry;
+    private intelligence;
+    private limits;
+    private callCount;
+    private lastCallTime;
+    private cache;
+    constructor(registry: FeatureRegistry, intelligence: IntelligenceProvider, limits?: Partial<EvaluatorLimits>);
+    /**
+     * Evaluate the current context and recommend a feature to surface (if any).
+     * Fail-open: errors/timeouts return { recommendation: null }.
+     */
+    evaluate(context: DiscoveryContext): Promise<DiscoveryEvaluation>;
+    /**
+     * Get current evaluator status for monitoring.
+     */
+    getStatus(): {
+        callsThisSession: number;
+        maxCallsPerSession: number;
+        cacheSize: number;
+        lastCallTime: number;
+        rateLimited: boolean;
+    };
+    /**
+     * Reset session state (call count, cache). Used when session restarts.
+     */
+    resetSession(): void;
+    /**
+     * Clear the evaluation cache. Useful when feature states change.
+     */
+    clearCache(): void;
+    /**
+     * Pre-filter features to only those eligible for surfacing.
+     * Returns at most maxFeaturesPerEval features.
+     */
+    preFilter(context: DiscoveryContext, userId: string): EligibleFeature[];
+    /**
+     * Build the evaluation prompt with structural delimiters.
+     * Uses sanitized context only — no raw user text.
+     */
+    buildPrompt(context: DiscoveryContext, eligible: EligibleFeature[]): string;
+    /**
+     * Parse and validate LLM response. Returns null if no valid recommendation.
+     */
+    validateOutput(response: string, eligible: EligibleFeature[], autonomyProfile: string): SurfacingRecommendation | null;
+    private isRateLimited;
+    private recordCall;
+    private getCached;
+    private cacheResult;
+    private callWithTimeout;
+    private getMaxSurfaces;
+    private categoryMatches;
+    private getTierPriority;
+    private capSurfaceLevel;
+}
+//# sourceMappingURL=DiscoveryEvaluator.d.ts.map

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

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

package/dist/core/DiscoveryEvaluator.js

@@ -0,0 +1,377 @@
+/**
+ * DiscoveryEvaluator — LLM-powered context evaluator for feature discovery.
+ *
+ * Part of the Consent & Discovery Framework (Phase 3: Context Evaluator).
+ *
+ * Architecture:
+ *   - Input sanitization: receives topic categories, not raw user text
+ *   - Pre-filtering: excludes ineligible features before LLM call
+ *   - Haiku-class LLM evaluation with structural prompt delimiters
+ *   - Output validation: featureId must exist in eligible set
+ *   - Rate limiting: max calls/session, min interval, result caching
+ *   - Fail-open: timeout/error → no surfacing, pull path unaffected
+ *
+ * The evaluator itself is a network-tier processing activity in the
+ * feature registry (it calls an external LLM API).
+ */
+// ── Constants ────────────────────────────────────────────────────────
+const DEFAULT_LIMITS = {
+    maxCallsPerSession: 3,
+    minIntervalMs: 300_000, // 5 minutes
+    resultCacheTtlMs: 600_000, // 10 minutes
+    timeoutMs: 5_000, // 5 seconds
+    maxFeaturesPerEval: 10,
+};
+const PROMPT_VERSION = 'v1.0';
+/** Discovery states that make a feature ineligible for surfacing */
+const INELIGIBLE_STATES = new Set(['enabled', 'disabled']);
+/** Autonomy profile → max surfaceAs level */
+const AUTONOMY_SURFACE_CAPS = {
+    cautious: 'awareness',
+    supervised: 'suggestion',
+    collaborative: 'prompt',
+    autonomous: 'prompt',
+};
+/** Valid surfaceAs levels in order of escalation */
+const SURFACE_LEVELS = ['awareness', 'suggestion', 'prompt'];
+// ── Main Class ───────────────────────────────────────────────────────
+export class DiscoveryEvaluator {
+    registry;
+    intelligence;
+    limits;
+    // Rate limiting state
+    callCount = 0;
+    lastCallTime = 0;
+    // Cache: topicCategory → { result, timestamp }
+    cache = new Map();
+    constructor(registry, intelligence, limits) {
+        this.registry = registry;
+        this.intelligence = intelligence;
+        this.limits = { ...DEFAULT_LIMITS, ...limits };
+    }
+    /**
+     * Evaluate the current context and recommend a feature to surface (if any).
+     * Fail-open: errors/timeouts return { recommendation: null }.
+     */
+    async evaluate(context) {
+        const userId = context.userId || 'default';
+        // Respect autonomy profile discovery aggressiveness
+        // 'passive' = only surface on explicit user request (pull-only, no push)
+        if (context.autonomyProfile === 'cautious') {
+            return {
+                recommendation: null,
+                cached: false,
+                rateLimited: false,
+                eligibleCount: 0,
+            };
+        }
+        // Check cache first
+        const cached = this.getCached(context.topicCategory);
+        if (cached) {
+            return { ...cached, cached: true };
+        }
+        // Check rate limits
+        if (this.isRateLimited()) {
+            return {
+                recommendation: null,
+                cached: false,
+                rateLimited: true,
+                eligibleCount: 0,
+            };
+        }
+        // Pre-filter eligible features
+        const eligible = this.preFilter(context, userId);
+        if (eligible.length === 0) {
+            const result = {
+                recommendation: null,
+                cached: false,
+                rateLimited: false,
+                eligibleCount: 0,
+            };
+            this.cacheResult(context.topicCategory, result);
+            return result;
+        }
+        // Build prompt and call LLM
+        const prompt = this.buildPrompt(context, eligible);
+        try {
+            const response = await this.callWithTimeout(prompt);
+            const recommendation = this.validateOutput(response, eligible, context.autonomyProfile);
+            const result = {
+                recommendation,
+                cached: false,
+                rateLimited: false,
+                eligibleCount: eligible.length,
+            };
+            this.recordCall();
+            this.cacheResult(context.topicCategory, result);
+            return result;
+        }
+        catch (err) {
+            // @silent-fallback-ok — Fail-open by design: evaluator errors never block agent operation
+            const errorMsg = err instanceof Error ? err.message : String(err);
+            return {
+                recommendation: null,
+                cached: false,
+                rateLimited: false,
+                eligibleCount: eligible.length,
+                error: errorMsg,
+            };
+        }
+    }
+    /**
+     * Get current evaluator status for monitoring.
+     */
+    getStatus() {
+        return {
+            callsThisSession: this.callCount,
+            maxCallsPerSession: this.limits.maxCallsPerSession,
+            cacheSize: this.cache.size,
+            lastCallTime: this.lastCallTime,
+            rateLimited: this.isRateLimited(),
+        };
+    }
+    /**
+     * Reset session state (call count, cache). Used when session restarts.
+     */
+    resetSession() {
+        this.callCount = 0;
+        this.lastCallTime = 0;
+        this.cache.clear();
+    }
+    /**
+     * Clear the evaluation cache. Useful when feature states change.
+     */
+    clearCache() {
+        this.cache.clear();
+    }
+    // ── Pre-Filtering ────────────────────────────────────────────────
+    /**
+     * Pre-filter features to only those eligible for surfacing.
+     * Returns at most maxFeaturesPerEval features.
+     */
+    preFilter(context, userId) {
+        if (!this.registry.isReady())
+            return [];
+        const allFeatures = this.registry.getAllFeatures(userId);
+        const eligible = [];
+        for (const info of allFeatures) {
+            const { definition, state } = info;
+            // Skip features in ineligible states
+            if (INELIGIBLE_STATES.has(state.discoveryState))
+                continue;
+            // Skip deferred features with active cooldown
+            if (state.discoveryState === 'deferred' && state.lastSurfacedAt) {
+                // Deferred features handled by state machine — excluded from evaluator
+                continue;
+            }
+            // Skip features that have been surfaced too many times
+            const maxSurfaces = this.getMaxSurfaces(definition);
+            if (state.surfaceCount >= maxSurfaces)
+                continue;
+            // Skip permanently-quiet features (declined too many times)
+            if (state.discoveryState === 'declined' && state.declineCount >= 3)
+                continue;
+            // Category match (coarse pre-filter)
+            const categoryMatch = this.categoryMatches(definition, context);
+            // Priority: undiscovered before aware, lower ConsentTier first
+            const statePriority = state.discoveryState === 'undiscovered' ? 0 : 1;
+            const tierPriority = this.getTierPriority(definition.consentTier);
+            const categoryBoost = categoryMatch ? 0 : 10;
+            const priority = statePriority + tierPriority + categoryBoost;
+            eligible.push({
+                feature: {
+                    id: definition.id,
+                    name: definition.name,
+                    category: definition.category,
+                    oneLiner: definition.oneLiner,
+                    consentTier: definition.consentTier,
+                    triggerConditions: definition.discoveryTriggers.map(t => t.condition),
+                },
+                priority,
+            });
+        }
+        // Sort by priority and cap
+        eligible.sort((a, b) => a.priority - b.priority);
+        return eligible.slice(0, this.limits.maxFeaturesPerEval).map(e => e.feature);
+    }
+    // ── Prompt Building ──────────────────────────────────────────────
+    /**
+     * Build the evaluation prompt with structural delimiters.
+     * Uses sanitized context only — no raw user text.
+     */
+    buildPrompt(context, eligible) {
+        const featureList = eligible.map(f => `- ${f.id} (${f.name}): ${f.oneLiner} [tier: ${f.consentTier}]\n  Triggers: ${f.triggerConditions.join('; ') || 'none specified'}`).join('\n');
+        return `<system>
+You are a feature discovery evaluator. Your job is to decide whether any of the
+listed features should be surfaced to the user RIGHT NOW based on their current
+context. You must respond with ONLY valid JSON — no markdown, no explanation
+outside the JSON.
+
+Rules:
+1. Surface AT MOST one feature per evaluation
+2. Only surface a feature if the context strongly suggests it would help
+3. Prefer "awareness" (lowest pressure) unless context strongly demands "suggestion"
+4. NEVER surface "prompt" for self-governing tier features
+5. If nothing is relevant, return {"featuresToSurface": []}
+6. The featureId MUST be one from the eligible list below
+7. messageForAgent should be a natural, conversational mention — NOT a sales pitch
+
+Response schema:
+{
+  "featuresToSurface": [
+    {
+      "featureId": "string (must match an id from the eligible list)",
+      "surfaceAs": "awareness | suggestion | prompt",
+      "reasoning": "brief explanation of why this is relevant now",
+      "messageForAgent": "natural mention the agent can use in conversation"
+    }
+  ]
+}
+
+If nothing is relevant, respond: {"featuresToSurface": []}
+</system>
+
+<context>
+Topic: ${context.topicCategory}
+Intent: ${context.conversationIntent}
+Problems: ${context.problemCategories.length > 0 ? context.problemCategories.join(', ') : 'none'}
+Autonomy: ${context.autonomyProfile}
+Enabled: ${context.enabledFeatures.length > 0 ? context.enabledFeatures.join(', ') : 'none'}
+</context>
+
+<eligible_features>
+${featureList}
+</eligible_features>
+
+Evaluate: should any of these features be surfaced given the current context? JSON only.`;
+    }
+    // ── Output Validation ────────────────────────────────────────────
+    /**
+     * Parse and validate LLM response. Returns null if no valid recommendation.
+     */
+    validateOutput(response, eligible, autonomyProfile) {
+        try {
+            // Extract JSON from response
+            const jsonMatch = response.match(/\{[\s\S]*\}/);
+            if (!jsonMatch)
+                return null;
+            const parsed = JSON.parse(jsonMatch[0]);
+            if (!parsed.featuresToSurface || !Array.isArray(parsed.featuresToSurface))
+                return null;
+            if (parsed.featuresToSurface.length === 0)
+                return null;
+            // Take only the first recommendation
+            const rec = parsed.featuresToSurface[0];
+            // Validate featureId exists in eligible set
+            const eligibleIds = new Set(eligible.map(f => f.id));
+            if (!eligibleIds.has(rec.featureId))
+                return null;
+            // Validate surfaceAs is valid
+            if (!SURFACE_LEVELS.includes(rec.surfaceAs))
+                return null;
+            // Cap surfaceAs by autonomy profile
+            const maxLevel = AUTONOMY_SURFACE_CAPS[autonomyProfile] || 'suggestion';
+            const cappedSurfaceAs = this.capSurfaceLevel(rec.surfaceAs, maxLevel);
+            // Block 'prompt' for self-governing tier features
+            const feature = eligible.find(f => f.id === rec.featureId);
+            if (feature && feature.consentTier === 'self-governing' && cappedSurfaceAs === 'prompt') {
+                return null;
+            }
+            // Validate required string fields
+            if (typeof rec.reasoning !== 'string' || !rec.reasoning)
+                return null;
+            if (typeof rec.messageForAgent !== 'string' || !rec.messageForAgent)
+                return null;
+            return {
+                featureId: rec.featureId,
+                surfaceAs: cappedSurfaceAs,
+                reasoning: rec.reasoning,
+                messageForAgent: rec.messageForAgent,
+            };
+        }
+        catch {
+            // @silent-fallback-ok — Malformed LLM output returns null (no recommendation), by design
+            return null;
+        }
+    }
+    // ── Private Helpers ──────────────────────────────────────────────
+    isRateLimited() {
+        if (this.callCount >= this.limits.maxCallsPerSession)
+            return true;
+        if (this.lastCallTime > 0) {
+            const elapsed = Date.now() - this.lastCallTime;
+            if (elapsed < this.limits.minIntervalMs)
+                return true;
+        }
+        return false;
+    }
+    recordCall() {
+        this.callCount++;
+        this.lastCallTime = Date.now();
+    }
+    getCached(topicCategory) {
+        const entry = this.cache.get(topicCategory);
+        if (!entry)
+            return null;
+        const elapsed = Date.now() - entry.timestamp;
+        if (elapsed > this.limits.resultCacheTtlMs) {
+            this.cache.delete(topicCategory);
+            return null;
+        }
+        return entry.result;
+    }
+    cacheResult(topicCategory, result) {
+        this.cache.set(topicCategory, { result, timestamp: Date.now() });
+    }
+    async callWithTimeout(prompt) {
+        const options = {
+            model: 'fast', // Haiku-class
+            maxTokens: 300,
+            temperature: 0,
+        };
+        // Race against timeout
+        const timeoutPromise = new Promise((_, reject) => {
+            setTimeout(() => reject(new Error('Evaluator timeout')), this.limits.timeoutMs);
+        });
+        return Promise.race([
+            this.intelligence.evaluate(prompt, options),
+            timeoutPromise,
+        ]);
+    }
+    getMaxSurfaces(definition) {
+        // Use the lowest maxSurfacesBeforeQuiet across all triggers
+        if (definition.discoveryTriggers.length === 0)
+            return 3; // default
+        return Math.min(...definition.discoveryTriggers.map(t => t.maxSurfacesBeforeQuiet));
+    }
+    categoryMatches(definition, context) {
+        // Check if any trigger conditions loosely match the topic or problems
+        const contextTerms = [
+            context.topicCategory.toLowerCase(),
+            context.conversationIntent.toLowerCase(),
+            ...context.problemCategories.map(p => p.toLowerCase()),
+        ];
+        const featureTerms = [
+            definition.category.toLowerCase(),
+            ...definition.discoveryTriggers.map(t => t.condition.toLowerCase()),
+        ];
+        return contextTerms.some(ct => featureTerms.some(ft => ft.includes(ct) || ct.includes(ft)));
+    }
+    getTierPriority(tier) {
+        switch (tier) {
+            case 'informational': return 0;
+            case 'local': return 1;
+            case 'network': return 2;
+            case 'self-governing': return 3;
+            default: return 4;
+        }
+    }
+    capSurfaceLevel(requested, max) {
+        const requestedIndex = SURFACE_LEVELS.indexOf(requested);
+        const maxIndex = SURFACE_LEVELS.indexOf(max);
+        if (requestedIndex <= maxIndex)
+            return requested;
+        return max;
+    }
+}
+//# sourceMappingURL=DiscoveryEvaluator.js.map

package/dist/core/DiscoveryEvaluator.js.map

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

package/dist/core/DispatchDecisionJournal.d.ts

@@ -0,0 +1,83 @@
+/**
+ * DispatchDecisionJournal — Dispatch-specific decision journal with query capabilities.
+ *
+ * Extends the base DecisionJournal to provide dispatch-specific logging and
+ * querying. This is the observability foundation for the Discernment Layer.
+ *
+ * Storage: Same JSONL file as DecisionJournal (decision-journal.jsonl).
+ * Dispatch entries are distinguished by `type: 'dispatch'` field.
+ *
+ * Milestone 1: Logging + querying. All entries are structural (auto-applied).
+ * Milestone 4: LLM evaluation adds contextual entries.
+ */
+import type { DispatchDecisionEntry } from './types.js';
+import { DecisionJournal } from './DecisionJournal.js';
+export interface DispatchDecisionStats {
+    /** Total dispatch decisions */
+    total: number;
+    /** Breakdown by decision type */
+    byDecision: Record<string, number>;
+    /** Breakdown by dispatch type */
+    byDispatchType: Record<string, number>;
+    /** Breakdown by evaluation method */
+    byEvaluationMethod: Record<string, number>;
+    /** Acceptance rate (accept / total) */
+    acceptanceRate: number;
+    /** ISO timestamp of earliest entry */
+    earliest: string | null;
+    /** ISO timestamp of latest entry */
+    latest: string | null;
+}
+export interface DispatchDecisionQueryOptions {
+    /** Filter by dispatch ID */
+    dispatchId?: string;
+    /** Filter by decision type */
+    decision?: DispatchDecisionEntry['dispatchDecision'];
+    /** Filter by dispatch type */
+    dispatchType?: string;
+    /** Filter by evaluation method */
+    evaluationMethod?: 'structural' | 'contextual';
+    /** Filter by tag */
+    tag?: string;
+    /** Only entries from the last N days */
+    days?: number;
+    /** Maximum entries to return (most recent first) */
+    limit?: number;
+}
+export declare class DispatchDecisionJournal {
+    private journalFile;
+    private baseJournal;
+    constructor(stateDir: string);
+    /**
+     * Log a dispatch integration decision.
+     */
+    logDispatchDecision(entry: Omit<DispatchDecisionEntry, 'timestamp' | 'type' | 'decision'>): DispatchDecisionEntry;
+    /**
+     * Query dispatch decision entries with filtering.
+     */
+    query(options?: DispatchDecisionQueryOptions): DispatchDecisionEntry[];
+    /**
+     * Get the decision for a specific dispatch ID.
+     * Returns the most recent decision if multiple exist (e.g., defer then accept).
+     */
+    getDecisionForDispatch(dispatchId: string): DispatchDecisionEntry | null;
+    /**
+     * Check if a dispatch has already been decided on.
+     */
+    hasDecision(dispatchId: string): boolean;
+    /**
+     * Get aggregate statistics for dispatch decisions.
+     */
+    stats(options?: {
+        days?: number;
+    }): DispatchDecisionStats;
+    /**
+     * Get the underlying base journal (for non-dispatch queries).
+     */
+    getBaseJournal(): DecisionJournal;
+    /**
+     * Read only dispatch-type entries from the JSONL file.
+     */
+    private readDispatchEntries;
+}
+//# sourceMappingURL=DispatchDecisionJournal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DispatchDecisionJournal.d.ts","sourceRoot":"","sources":["../../src/core/DispatchDecisionJournal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAIvD,MAAM,WAAW,qBAAqB;IACpC,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,iCAAiC;IACjC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,qCAAqC;IACrC,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,uCAAuC;IACvC,cAAc,EAAE,MAAM,CAAC;IACvB,sCAAsC;IACtC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,oCAAoC;IACpC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,4BAA4B;IAC3C,4BAA4B;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,qBAAqB,CAAC,kBAAkB,CAAC,CAAC;IACrD,8BAA8B;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,gBAAgB,CAAC,EAAE,YAAY,GAAG,YAAY,CAAC;IAC/C,oBAAoB;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,uBAAuB;IAClC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAkB;gBAEzB,QAAQ,EAAE,MAAM;IAK5B;;OAEG;IACH,mBAAmB,CACjB,KAAK,EAAE,IAAI,CAAC,qBAAqB,EAAE,WAAW,GAAG,MAAM,GAAG,UAAU,CAAC,GACpE,qBAAqB;IAoBxB;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,EAAE,4BAA4B,GAAG,qBAAqB,EAAE;IAiCtE;;;OAGG;IACH,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI;IAKxE;;OAEG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAIxC;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,qBAAqB;IA0CzD;;OAEG;IACH,cAAc,IAAI,eAAe;IAIjC;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAkC5B"}