twining-mcp 1.3.0

package/dist/engine/context-assembler.js

@@ -0,0 +1,483 @@
+import { DEFAULT_LIVENESS_THRESHOLDS } from "../utils/liveness.js";
+import { computeLiveness } from "../utils/liveness.js";
+import { normalizeTags } from "../utils/tags.js";
+import { estimateTokens } from "../utils/tokens.js";
+/** Half-life for recency decay in hours (one week). */
+const RECENCY_HALF_LIFE = 168;
+export class ContextAssembler {
+    blackboardStore;
+    decisionStore;
+    searchEngine;
+    config;
+    graphEngine;
+    planningBridge;
+    handoffStore;
+    agentStore;
+    constructor(blackboardStore, decisionStore, searchEngine, config, graphEngine, planningBridge, handoffStore, agentStore) {
+        this.blackboardStore = blackboardStore;
+        this.decisionStore = decisionStore;
+        this.searchEngine = searchEngine;
+        this.config = config;
+        this.graphEngine = graphEngine ?? null;
+        this.planningBridge = planningBridge ?? null;
+        this.handoffStore = handoffStore ?? null;
+        this.agentStore = agentStore ?? null;
+    }
+    /**
+     * Build tailored context for a specific task within a token budget.
+     * Implements spec section 4.3 (twining_assemble).
+     */
+    async assemble(task, scope, maxTokens) {
+        const budget = maxTokens ?? this.config.context_assembly.default_max_tokens;
+        const weights = this.config.context_assembly.priority_weights;
+        const now = Date.now();
+        // Load all data once upfront to avoid redundant disk reads
+        const { entries: allEntries } = await this.blackboardStore.read();
+        const allIndex = await this.decisionStore.getIndex();
+        // 1. Retrieve scope-matched decisions
+        const scopeDecisions = await this.decisionStore.getByScope(scope);
+        const activeDecisions = scopeDecisions.filter((d) => d.status === "active" || d.status === "provisional");
+        // 2. Retrieve semantically relevant decisions (merge by ID, keep highest relevance)
+        const decisionRelevance = new Map();
+        if (this.searchEngine) {
+            const allDecisions = [];
+            for (const entry of allIndex) {
+                if (entry.status === "active" || entry.status === "provisional") {
+                    const d = await this.decisionStore.get(entry.id);
+                    if (d)
+                        allDecisions.push(d);
+                }
+            }
+            const { results: semanticDecisions } = await this.searchEngine.searchDecisions(task, allDecisions);
+            for (const sr of semanticDecisions) {
+                decisionRelevance.set(sr.decision.id, sr.relevance);
+            }
+        }
+        // Merge scope-matched and semantic decisions (union by ID)
+        const mergedDecisionMap = new Map();
+        for (const d of activeDecisions) {
+            mergedDecisionMap.set(d.id, d);
+            if (!decisionRelevance.has(d.id)) {
+                decisionRelevance.set(d.id, 0.5); // Default relevance for scope-only matches
+            }
+        }
+        if (this.searchEngine) {
+            for (const entry of allIndex) {
+                if (decisionRelevance.has(entry.id) &&
+                    !mergedDecisionMap.has(entry.id)) {
+                    const d = await this.decisionStore.get(entry.id);
+                    if (d && (d.status === "active" || d.status === "provisional")) {
+                        mergedDecisionMap.set(d.id, d);
+                    }
+                }
+            }
+        }
+        // 3. Retrieve scope-matched blackboard entries (filter from cached allEntries)
+        const scopeEntries = allEntries.filter((e) => e.scope.startsWith(scope) || scope.startsWith(e.scope));
+        // 4. Retrieve semantically relevant findings
+        const entryRelevance = new Map();
+        if (this.searchEngine) {
+            const { results: semanticEntries } = await this.searchEngine.searchBlackboard(task, allEntries);
+            for (const sr of semanticEntries) {
+                entryRelevance.set(sr.entry.id, sr.relevance);
+            }
+        }
+        // Merge entries — scope + semantic
+        const mergedEntryMap = new Map();
+        for (const e of scopeEntries) {
+            mergedEntryMap.set(e.id, e);
+            if (!entryRelevance.has(e.id)) {
+                entryRelevance.set(e.id, 0.5);
+            }
+        }
+        if (this.searchEngine) {
+            for (const e of allEntries) {
+                if (entryRelevance.has(e.id) && !mergedEntryMap.has(e.id)) {
+                    mergedEntryMap.set(e.id, e);
+                }
+            }
+        }
+        // 5. Score each item
+        const scoredItems = [];
+        for (const [id, decision] of mergedDecisionMap) {
+            const recency = this.recencyScore(decision.timestamp, now);
+            const relevance = decisionRelevance.get(id) ?? 0.5;
+            const confidence = this.confidenceScore(decision.confidence);
+            const warningBoost = 0;
+            const score = recency * weights.recency +
+                relevance * weights.relevance +
+                confidence * weights.decision_confidence +
+                warningBoost * weights.warning_boost;
+            const text = `${decision.summary} ${decision.rationale} ${decision.confidence} ${decision.affected_files.join(", ")}`;
+            scoredItems.push({
+                type: "decision",
+                id,
+                score,
+                tokenCost: estimateTokens(text),
+                data: decision,
+            });
+        }
+        for (const [id, entry] of mergedEntryMap) {
+            const recency = this.recencyScore(entry.timestamp, now);
+            const relevance = entryRelevance.get(id) ?? 0.5;
+            const confidence = 0.5; // Neutral for non-decisions
+            const warningBoost = entry.entry_type === "warning" ? 1.0 : 0.0;
+            const score = recency * weights.recency +
+                relevance * weights.relevance +
+                confidence * weights.decision_confidence +
+                warningBoost * weights.warning_boost;
+            const text = `${entry.summary} ${entry.detail}`;
+            scoredItems.push({
+                type: entry.entry_type,
+                id,
+                score,
+                tokenCost: estimateTokens(text),
+                data: entry,
+            });
+        }
+        // 6. Fill token budget in priority order
+        // Reserve 10% for warnings
+        const warningBudget = Math.floor(budget * 0.1);
+        const mainBudget = budget - warningBudget;
+        // Separate warnings and non-warnings
+        const warnings = scoredItems.filter((i) => i.type === "warning");
+        const nonWarnings = scoredItems.filter((i) => i.type !== "warning");
+        warnings.sort((a, b) => b.score - a.score);
+        nonWarnings.sort((a, b) => b.score - a.score);
+        const selected = new Set();
+        let tokensUsed = 0;
+        // First: fill warnings with reserved budget
+        for (const item of warnings) {
+            if (tokensUsed + item.tokenCost <= budget) {
+                selected.add(item.id);
+                tokensUsed += item.tokenCost;
+            }
+        }
+        // Then: fill non-warnings with remaining budget
+        for (const item of nonWarnings) {
+            if (tokensUsed + item.tokenCost <= budget) {
+                selected.add(item.id);
+                tokensUsed += item.tokenCost;
+            }
+        }
+        // Also include needs even if low-scored (safety)
+        for (const item of scoredItems) {
+            if (item.type === "need" &&
+                !selected.has(item.id) &&
+                tokensUsed + item.tokenCost <= budget) {
+                selected.add(item.id);
+                tokensUsed += item.tokenCost;
+            }
+        }
+        // 7. Build AssembledContext
+        const activeDecisionResults = [];
+        const openNeeds = [];
+        const recentFindings = [];
+        const activeWarnings = [];
+        const recentQuestions = [];
+        for (const item of scoredItems) {
+            if (!selected.has(item.id))
+                continue;
+            if (item.type === "decision") {
+                const d = item.data;
+                activeDecisionResults.push({
+                    id: d.id,
+                    summary: d.summary,
+                    rationale: d.rationale,
+                    confidence: d.confidence,
+                    affected_files: d.affected_files,
+                });
+            }
+            else {
+                const e = item.data;
+                switch (e.entry_type) {
+                    case "need":
+                        openNeeds.push({
+                            id: e.id,
+                            summary: e.summary,
+                            scope: e.scope,
+                            timestamp: e.timestamp,
+                        });
+                        break;
+                    case "warning":
+                        activeWarnings.push({
+                            id: e.id,
+                            summary: e.summary,
+                            detail: e.detail,
+                            scope: e.scope,
+                            timestamp: e.timestamp,
+                        });
+                        break;
+                    case "finding":
+                        recentFindings.push({
+                            id: e.id,
+                            summary: e.summary,
+                            detail: e.detail,
+                            scope: e.scope,
+                            timestamp: e.timestamp,
+                        });
+                        break;
+                    case "question":
+                        recentQuestions.push({
+                            id: e.id,
+                            summary: e.summary,
+                            scope: e.scope,
+                            timestamp: e.timestamp,
+                        });
+                        break;
+                    // Other entry types go into findings as a catch-all
+                    default:
+                        recentFindings.push({
+                            id: e.id,
+                            summary: e.summary,
+                            detail: e.detail,
+                            scope: e.scope,
+                            timestamp: e.timestamp,
+                        });
+                        break;
+                }
+            }
+        }
+        // 8. Populate related_entities from knowledge graph
+        const relatedEntities = await this.getRelatedEntities(scope);
+        const result = {
+            assembled_at: new Date().toISOString(),
+            task,
+            scope,
+            token_estimate: tokensUsed,
+            active_decisions: activeDecisionResults,
+            open_needs: openNeeds,
+            recent_findings: recentFindings,
+            active_warnings: activeWarnings,
+            recent_questions: recentQuestions,
+            related_entities: relatedEntities,
+        };
+        // 9. Integrate planning state from .planning/ directory
+        const planningState = this.planningBridge?.readPlanningState() ?? null;
+        if (planningState) {
+            // Always include planning_state as metadata (not subject to token budget)
+            result.planning_state = planningState;
+            // Add a synthetic scored finding for planning context so it competes
+            // for token budget alongside other items (GSDB-04)
+            let planningText = `Planning: Phase ${planningState.current_phase}, Progress: ${planningState.progress}`;
+            if (planningState.blockers.length > 0) {
+                planningText += `. Blockers: ${planningState.blockers.join("; ")}`;
+            }
+            const planningTokenCost = estimateTokens(planningText);
+            const planningScore = 1.0 * weights.recency + // always fresh
+                0.5 * weights.relevance + // moderate default relevance
+                0.5 * weights.decision_confidence;
+            if (tokensUsed + planningTokenCost <= budget) {
+                recentFindings.push({
+                    id: "planning-state",
+                    summary: planningText,
+                    detail: planningState.open_requirements.length > 0
+                        ? `Open requirements: ${planningState.open_requirements.join(", ")}`
+                        : "",
+                    scope: "project",
+                    timestamp: new Date().toISOString(),
+                });
+                result.token_estimate += planningTokenCost;
+            }
+        }
+        // 10. Include recent handoffs matching scope (HND-03)
+        if (this.handoffStore) {
+            const handoffEntries = await this.handoffStore.list({ scope, limit: 5 });
+            if (handoffEntries.length > 0) {
+                result.recent_handoffs = handoffEntries.map((h) => ({
+                    id: h.id,
+                    source_agent: h.source_agent,
+                    target_agent: h.target_agent ?? "",
+                    scope: h.scope ?? "",
+                    summary: h.summary,
+                    result_status: h.result_status,
+                    acknowledged: h.acknowledged,
+                    created_at: h.created_at,
+                }));
+            }
+        }
+        // 11. Include suggested agents with matching capabilities (HND-06)
+        if (this.agentStore) {
+            const allAgents = await this.agentStore.getAll();
+            const thresholds = this.config.agents?.liveness ?? DEFAULT_LIVENESS_THRESHOLDS;
+            const taskTerms = normalizeTags(task.split(/\s+/));
+            const suggestedAgents = [];
+            for (const agent of allAgents) {
+                const liveness = computeLiveness(agent.last_active, new Date(), thresholds);
+                if (liveness === "gone")
+                    continue;
+                const normalizedCaps = normalizeTags(agent.capabilities);
+                const hasMatch = normalizedCaps.some((cap) => taskTerms.some((term) => term.includes(cap) || cap.includes(term)));
+                if (hasMatch) {
+                    suggestedAgents.push({
+                        agent_id: agent.agent_id,
+                        capabilities: agent.capabilities,
+                        liveness,
+                    });
+                }
+            }
+            if (suggestedAgents.length > 0) {
+                result.suggested_agents = suggestedAgents;
+            }
+        }
+        return result;
+    }
+    /**
+     * High-level summary of project or scope state.
+     * Implements spec section 4.3 (twining_summarize).
+     */
+    async summarize(scope) {
+        const targetScope = scope ?? "project";
+        // Get decisions
+        const index = await this.decisionStore.getIndex();
+        const scopeIndex = targetScope === "project"
+            ? index
+            : index.filter((e) => e.scope.startsWith(targetScope) ||
+                targetScope.startsWith(e.scope));
+        const activeDecisions = scopeIndex.filter((e) => e.status === "active").length;
+        const provisionalDecisions = scopeIndex.filter((e) => e.status === "provisional").length;
+        // Get blackboard entries
+        const readOpts = targetScope === "project" ? undefined : { scope: targetScope };
+        const { entries } = await this.blackboardStore.read(readOpts);
+        const openNeeds = entries.filter((e) => e.entry_type === "need").length;
+        const activeWarnings = entries.filter((e) => e.entry_type === "warning").length;
+        const unansweredQuestions = entries.filter((e) => e.entry_type === "question").length;
+        // Recent activity (last 24 hours)
+        const twentyFourHoursAgo = new Date(Date.now() - 24 * 60 * 60 * 1000).toISOString();
+        const recentEntries = entries.filter((e) => e.timestamp >= twentyFourHoursAgo);
+        const recentDecisionCount = scopeIndex.filter((e) => e.timestamp >= twentyFourHoursAgo).length;
+        const recentFindingCount = recentEntries.filter((e) => e.entry_type === "finding").length;
+        const recentWarningCount = recentEntries.filter((e) => e.entry_type === "warning").length;
+        let recentActivitySummary = `In the last 24 hours: ${recentDecisionCount} decision${recentDecisionCount !== 1 ? "s" : ""} made, ` +
+            `${recentFindingCount} finding${recentFindingCount !== 1 ? "s" : ""} posted, ` +
+            `${recentWarningCount} warning${recentWarningCount !== 1 ? "s" : ""} raised.`;
+        // Integrate planning state from .planning/ directory
+        const planningState = this.planningBridge?.readPlanningState() ?? null;
+        if (planningState) {
+            recentActivitySummary += ` Current phase: ${planningState.current_phase}. Progress: ${planningState.progress}.`;
+        }
+        const result = {
+            scope: targetScope,
+            active_decisions: activeDecisions,
+            provisional_decisions: provisionalDecisions,
+            open_needs: openNeeds,
+            active_warnings: activeWarnings,
+            unanswered_questions: unansweredQuestions,
+            recent_activity_summary: recentActivitySummary,
+        };
+        if (planningState) {
+            result.planning_state = planningState;
+        }
+        return result;
+    }
+    /**
+     * Report changes since a given point in time.
+     * Implements spec section 4.3 (twining_what_changed).
+     */
+    async whatChanged(since, scope) {
+        // Get new entries since timestamp
+        const readOpts = { since };
+        if (scope)
+            readOpts.scope = scope;
+        const { entries } = await this.blackboardStore.read(readOpts);
+        const newEntries = entries.map((e) => ({
+            id: e.id,
+            entry_type: e.entry_type,
+            summary: e.summary,
+        }));
+        // Get decisions since timestamp
+        const index = await this.decisionStore.getIndex();
+        let filteredIndex = index.filter((e) => e.timestamp >= since);
+        if (scope) {
+            filteredIndex = filteredIndex.filter((e) => e.scope.startsWith(scope) || scope.startsWith(e.scope));
+        }
+        const newDecisions = filteredIndex
+            .filter((e) => e.status === "active" || e.status === "provisional")
+            .map((e) => ({ id: e.id, summary: e.summary }));
+        // Find overridden decisions since timestamp
+        const overriddenDecisions = [];
+        const allOverridden = index.filter((e) => e.status === "overridden");
+        for (const entry of allOverridden) {
+            const decision = await this.decisionStore.get(entry.id);
+            if (decision && decision.timestamp >= since) {
+                if (!scope || decision.scope.startsWith(scope) || scope.startsWith(decision.scope)) {
+                    overriddenDecisions.push({
+                        id: decision.id,
+                        summary: decision.summary,
+                        reason: decision.override_reason ?? "No reason provided",
+                    });
+                }
+            }
+        }
+        // Find reconsidered (provisional) decisions since timestamp
+        const reconsideredDecisions = filteredIndex
+            .filter((e) => e.status === "provisional")
+            .map((e) => ({ id: e.id, summary: e.summary }));
+        return {
+            new_decisions: newDecisions,
+            new_entries: newEntries,
+            overridden_decisions: overriddenDecisions,
+            reconsidered_decisions: reconsideredDecisions,
+        };
+    }
+    /**
+     * Populate related_entities from the knowledge graph.
+     * Finds entities matching the scope and gets their immediate neighbors.
+     * Never throws — graph errors are silently caught to avoid breaking context assembly.
+     */
+    async getRelatedEntities(scope) {
+        if (!this.graphEngine)
+            return [];
+        try {
+            // Search for entities whose name matches the scope
+            const { entities } = await this.graphEngine.query(scope, undefined, 5);
+            if (entities.length === 0)
+                return [];
+            const relatedEntities = [];
+            for (const entity of entities) {
+                try {
+                    const { neighbors } = await this.graphEngine.neighbors(entity.id, 1);
+                    const relations = neighbors.map((n) => `${n.relation.type}: ${n.entity.name}`);
+                    relatedEntities.push({
+                        name: entity.name,
+                        type: entity.type,
+                        relations,
+                    });
+                }
+                catch {
+                    // Skip entities that fail to traverse
+                    relatedEntities.push({
+                        name: entity.name,
+                        type: entity.type,
+                        relations: [],
+                    });
+                }
+            }
+            return relatedEntities;
+        }
+        catch {
+            // Graph errors should never break context assembly
+            return [];
+        }
+    }
+    /** Compute recency score using exponential decay. */
+    recencyScore(timestamp, now) {
+        const ageMs = now - new Date(timestamp).getTime();
+        const ageHours = ageMs / (1000 * 60 * 60);
+        return Math.exp(-ageHours / RECENCY_HALF_LIFE);
+    }
+    /** Convert decision confidence to a numeric score. */
+    confidenceScore(confidence) {
+        switch (confidence) {
+            case "high":
+                return 1.0;
+            case "medium":
+                return 0.6;
+            case "low":
+                return 0.3;
+            default:
+                return 0.5;
+        }
+    }
+}
+//# sourceMappingURL=context-assembler.js.map

package/dist/engine/context-assembler.js.map

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

package/dist/engine/coordination.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Coordination engine for agent discovery, delegation, and handoffs.
+ * Provides scoring algorithm and discovery method for ranking agents
+ * by capability overlap and liveness.
+ */
+import type { AgentStore } from "../storage/agent-store.js";
+import type { HandoffStore } from "../storage/handoff-store.js";
+import type { BlackboardEngine } from "./blackboard.js";
+import type { DecisionStore } from "../storage/decision-store.js";
+import type { BlackboardStore } from "../storage/blackboard-store.js";
+import type { AgentRecord, AgentScore, LivenessThresholds, DiscoverInput, DiscoverResult, DelegationInput, DelegationResult, DelegationMetadata, DelegationUrgency, BlackboardEntry, CreateHandoffInput, HandoffRecord, TwiningConfig } from "../utils/types.js";
+/**
+ * Score an agent against required capabilities and liveness.
+ * Pure function — no side effects, fully testable in isolation.
+ *
+ * Weighting: 70% capability overlap + 30% liveness score.
+ */
+export declare function scoreAgent(agent: AgentRecord, requiredCapabilities: string[], livenessThresholds: LivenessThresholds, now?: Date): AgentScore;
+/** Default timeout durations per urgency level. */
+export declare const DELEGATION_TIMEOUTS: Record<DelegationUrgency, number>;
+/**
+ * Parse delegation metadata from a blackboard entry's detail field.
+ * Returns null for non-delegation entries or malformed JSON.
+ */
+export declare function parseDelegationMetadata(entry: BlackboardEntry): DelegationMetadata | null;
+/**
+ * Check if a delegation has expired.
+ * Returns true when now >= expires_at (boundary inclusive).
+ */
+export declare function isDelegationExpired(metadata: DelegationMetadata, now?: Date): boolean;
+export declare class CoordinationEngine {
+    private readonly agentStore;
+    private readonly handoffStore;
+    private readonly blackboardEngine;
+    private readonly decisionStore;
+    private readonly blackboardStore;
+    private readonly config;
+    constructor(agentStore: AgentStore, handoffStore: HandoffStore, blackboardEngine: BlackboardEngine, decisionStore: DecisionStore, blackboardStore: BlackboardStore, config: TwiningConfig);
+    /** Discover and rank agents by capability match and liveness. */
+    discover(input: DiscoverInput): Promise<DiscoverResult>;
+    /** Post a delegation request to the blackboard. */
+    postDelegation(input: DelegationInput): Promise<DelegationResult>;
+    /**
+     * Assemble a context snapshot from active decisions and blackboard
+     * warnings/findings. Used by createHandoff when auto_snapshot is true.
+     */
+    private assembleContextSnapshot;
+    /** Create a handoff record between agents. */
+    createHandoff(input: CreateHandoffInput): Promise<HandoffRecord>;
+    /** Acknowledge receipt of a handoff. */
+    acknowledgeHandoff(handoffId: string, agentId: string): Promise<HandoffRecord>;
+}
+//# sourceMappingURL=coordination.d.ts.map

package/dist/engine/coordination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordination.d.ts","sourceRoot":"","sources":["../../src/engine/coordination.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAMtE,OAAO,KAAK,EACV,WAAW,EAEX,UAAU,EACV,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,aAAa,EACd,MAAM,mBAAmB,CAAC;AAc3B;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,WAAW,EAClB,oBAAoB,EAAE,MAAM,EAAE,EAC9B,kBAAkB,EAAE,kBAAkB,EACtC,GAAG,GAAE,IAAiB,GACrB,UAAU,CA+BZ;AAED,mDAAmD;AACnD,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAIjE,CAAC;AAEF;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,eAAe,GACrB,kBAAkB,GAAG,IAAI,CAW3B;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,kBAAkB,EAC5B,GAAG,GAAE,IAAiB,GACrB,OAAO,CAET;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;IACpD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;gBAGrC,UAAU,EAAE,UAAU,EACtB,YAAY,EAAE,YAAY,EAC1B,gBAAgB,EAAE,gBAAgB,EAClC,aAAa,EAAE,aAAa,EAC5B,eAAe,EAAE,eAAe,EAChC,MAAM,EAAE,aAAa;IAUvB,iEAAiE;IAC3D,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IA8B7D,mDAAmD;IAC7C,cAAc,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAsDvE;;;OAGG;YACW,uBAAuB;IA2CrC,8CAA8C;IACxC,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC;IA4CtE,wCAAwC;IAClC,kBAAkB,CACtB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,aAAa,CAAC;CAG1B"}