cognitive-core 0.2.4 → 0.3.1

package/dist/experimental/team/team-meta-learner.js

@@ -0,0 +1,404 @@
+/**
+ * Team Meta-Learner
+ *
+ * Learns about team formation and coordination decisions.
+ * Analyzes TeamMetaObservations to generate TeamMetaStrategies.
+ * Adjusts team recommendations based on learned patterns.
+ *
+ * The team-level analog of MetaLearner.
+ */
+import { createTeamMetaObservation, createTeamMetaStrategy } from './team-meta.js';
+const DEFAULT_CONFIG = {
+    minObservationsForStrategies: 5,
+    strategyGenerationInterval: 5,
+    preferTopologyThreshold: 0.75,
+    highOverheadThreshold: 0.4,
+};
+// ============================================================
+// Team Meta-Learner
+// ============================================================
+export class TeamMetaLearner {
+    memory;
+    config;
+    observationCount = 0;
+    constructor(memory, config) {
+        this.memory = memory;
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Generate a meta-observation from a completed team trajectory and
+     * the recommendation that was used to form the team (if any).
+     */
+    async generateReflection(trajectory, recommendation) {
+        // Assess composition effectiveness from graph data
+        const roleUtilization = {};
+        const redundantRoles = [];
+        const missingRoles = [];
+        for (const member of trajectory.members) {
+            const traj = member.trajectory;
+            roleUtilization[member.role] = traj.outcome?.success
+                ? 1.0
+                : (traj.outcome?.partialScore ?? 0);
+            // Redundant if no steps and minimal tokens
+            if (traj.steps.length === 0 && (traj.totalTokens ?? 0) < 1000) {
+                redundantRoles.push(member.role);
+            }
+        }
+        // Team size assessment
+        let teamSizeAssessment;
+        if (redundantRoles.length > 0) {
+            teamSizeAssessment = 'too-large';
+        }
+        else if (!trajectory.outcome.success && trajectory.metrics.reDelegationCount > 0) {
+            teamSizeAssessment = 'too-small';
+        }
+        else {
+            teamSizeAssessment = 'right-sized';
+        }
+        // Topology assessment from graph data
+        const parallelismRatio = trajectory.graphMetrics.parallelismRatio;
+        const topologyAssessment = trajectory.outcome.success && parallelismRatio > 0.3
+            ? 'effective'
+            : trajectory.outcome.success
+                ? 'neutral'
+                : 'hindering';
+        // Coordination effectiveness
+        const coordOverhead = trajectory.metrics.coordinationOverheadRatio;
+        const enforcementAssessment = coordOverhead > this.config.highOverheadThreshold
+            ? 'too-strict'
+            : 'appropriate';
+        // Bottleneck detection from graph metrics
+        const bottlenecks = [];
+        if (trajectory.graphMetrics.maxInDegree.count > 0) {
+            bottlenecks.push(trajectory.graphMetrics.maxInDegree.agentId);
+        }
+        // Outcome observation
+        const speedupEstimate = trajectory.teamSize > 1 ? trajectory.teamSize * parallelismRatio : 1;
+        const costEfficiency = trajectory.outcome.totalTokens > 0
+            ? trajectory.outcome.partialScore / (trajectory.outcome.totalTokens / 10000)
+            : 0;
+        // Lessons
+        const whatWorked = [];
+        const whatFailed = [];
+        const formationSuggestions = [];
+        const coordinationSuggestions = [];
+        if (trajectory.outcome.success) {
+            whatWorked.push(`${trajectory.topologyType} topology with ${trajectory.teamSize} agents succeeded`);
+            if (parallelismRatio > 0.5) {
+                whatWorked.push('Good parallelism achieved');
+            }
+        }
+        else {
+            whatFailed.push(`${trajectory.topologyType} topology with ${trajectory.teamSize} agents failed`);
+            if (trajectory.metrics.reDelegationCount > 0) {
+                whatFailed.push(`${trajectory.metrics.reDelegationCount} task re-delegations occurred`);
+                formationSuggestions.push('Consider adding specialist roles to reduce re-delegation');
+            }
+        }
+        if (redundantRoles.length > 0) {
+            whatFailed.push(`Redundant roles: ${redundantRoles.join(', ')}`);
+            formationSuggestions.push(`Consider removing roles: ${redundantRoles.join(', ')}`);
+        }
+        if (coordOverhead > this.config.highOverheadThreshold) {
+            coordinationSuggestions.push(`High coordination overhead (${(coordOverhead * 100).toFixed(0)}%); consider looser enforcement or fewer channels`);
+        }
+        const observation = createTeamMetaObservation({
+            teamTrajectoryId: trajectory.id,
+            formation: {
+                playbookUsed: recommendation?.playbook?.id,
+                formationMethod: recommendation?.playbook ? 'playbook' : 'manual',
+                confidence: recommendation?.confidence ?? 0.3,
+                reasoning: recommendation?.reasoning ?? 'Team formed without recommendation',
+                wasEffective: trajectory.outcome.success,
+                topologyUsed: trajectory.topologyType,
+                domain: trajectory.domain,
+            },
+            compositionEffectiveness: {
+                roleUtilization,
+                missingRoles,
+                redundantRoles,
+                teamSizeAssessment,
+                topologyAssessment,
+            },
+            coordinationEffectiveness: {
+                enforcementAssessment,
+                channelEffectiveness: 'neutral',
+                bottlenecks,
+                coordinationOverhead: coordOverhead,
+            },
+            outcome: {
+                success: trajectory.outcome.success,
+                quality: trajectory.outcome.quality,
+                speedupEstimate,
+                costEfficiency,
+            },
+            lessons: {
+                whatWorked,
+                whatFailed,
+                formationSuggestions,
+                coordinationSuggestions,
+            },
+        });
+        // Store the observation
+        await this.memory.recordMetaObservation(observation);
+        this.observationCount++;
+        // Periodically generate new meta-strategies
+        if (this.observationCount > 0 &&
+            this.observationCount % this.config.strategyGenerationInterval === 0) {
+            await this.learn();
+        }
+        return observation;
+    }
+    /**
+     * Analyze accumulated observations and generate team meta-strategies.
+     */
+    async learn() {
+        const observations = await this.memory.getMetaObservations();
+        if (observations.length < this.config.minObservationsForStrategies) {
+            return [];
+        }
+        const newStrategies = [];
+        // Analyze topology effectiveness across observations
+        const topologyStats = this.analyzeTopologyEffectiveness(observations);
+        for (const [topology, stats] of Object.entries(topologyStats)) {
+            if (stats.total < 3)
+                continue;
+            const successRate = stats.successful / stats.total;
+            if (successRate >= this.config.preferTopologyThreshold) {
+                const strategy = createTeamMetaStrategy({
+                    name: `prefer-${topology}-high-success`,
+                    condition: {
+                        taskCharacteristics: [],
+                        resourceConstraints: [],
+                        domains: stats.domains,
+                    },
+                    adjustment: {
+                        topologyBias: { [topology]: 0.3 },
+                        teamSizeAdjustment: 'maintain',
+                        roleAdjustments: [],
+                        coordinationHints: [
+                            `${topology} topology has ${(successRate * 100).toFixed(0)}% success rate`,
+                        ],
+                    },
+                });
+                newStrategies.push(strategy);
+            }
+            else if (successRate < 0.4 && stats.total >= 3) {
+                const strategy = createTeamMetaStrategy({
+                    name: `avoid-${topology}-low-success`,
+                    condition: {
+                        taskCharacteristics: [],
+                        resourceConstraints: [],
+                        domains: stats.domains,
+                    },
+                    adjustment: {
+                        topologyBias: { [topology]: -0.3 },
+                        teamSizeAdjustment: 'maintain',
+                        roleAdjustments: [],
+                        coordinationHints: [
+                            `${topology} topology has only ${(successRate * 100).toFixed(0)}% success rate`,
+                        ],
+                    },
+                });
+                newStrategies.push(strategy);
+            }
+        }
+        // Analyze team size patterns
+        const sizeAnalysis = this.analyzeTeamSizePatterns(observations);
+        if (sizeAnalysis) {
+            newStrategies.push(sizeAnalysis);
+        }
+        // Analyze coordination overhead patterns
+        const overheadAnalysis = this.analyzeOverheadPatterns(observations);
+        if (overheadAnalysis) {
+            newStrategies.push(overheadAnalysis);
+        }
+        // Store new strategies (deduplicating by name)
+        const existingStrategies = await this.memory.getMetaStrategies();
+        const existingNames = new Set(existingStrategies.map((s) => s.name));
+        for (const strategy of newStrategies) {
+            if (!existingNames.has(strategy.name)) {
+                await this.memory.storeMetaStrategy(strategy);
+                existingNames.add(strategy.name);
+            }
+        }
+        return newStrategies;
+    }
+    /**
+     * Adjust a team recommendation based on learned meta-strategies.
+     */
+    async adjustRecommendation(recommendation, input) {
+        const strategies = await this.memory.getMatchingMetaStrategies({
+            domains: [input.domain],
+            taskCharacteristics: this.extractTaskCharacteristics(input),
+        });
+        if (strategies.length === 0) {
+            return recommendation;
+        }
+        let adjustedConfidence = recommendation.confidence;
+        const adjustmentReasons = [];
+        const strategyNames = [];
+        for (const strategy of strategies) {
+            strategyNames.push(strategy.name);
+            // Apply topology bias
+            if (strategy.adjustment.topologyBias) {
+                const currentTopology = recommendation.composition.topology;
+                const currentBias = strategy.adjustment.topologyBias[currentTopology] ?? 0;
+                adjustedConfidence += currentBias * 0.2;
+                // Check if another topology is strongly preferred
+                for (const [topology, bias] of Object.entries(strategy.adjustment.topologyBias)) {
+                    if (bias > 0.2 && topology !== currentTopology && recommendation.confidence < 0.5) {
+                        recommendation = {
+                            ...recommendation,
+                            composition: {
+                                ...recommendation.composition,
+                                topology: topology,
+                            },
+                        };
+                        adjustmentReasons.push(`Meta-strategy "${strategy.name}" suggests ${topology} topology`);
+                    }
+                }
+            }
+            // Apply team size adjustment
+            if (strategy.adjustment.teamSizeAdjustment !== 'maintain') {
+                adjustmentReasons.push(`Meta-strategy "${strategy.name}" suggests ${strategy.adjustment.teamSizeAdjustment} team size`);
+            }
+            // Apply coordination hints
+            for (const hint of strategy.adjustment.coordinationHints) {
+                adjustmentReasons.push(hint);
+            }
+            // Apply enforcement bias
+            if (strategy.adjustment.enforcementBias &&
+                recommendation.composition.enforcement !== strategy.adjustment.enforcementBias) {
+                recommendation = {
+                    ...recommendation,
+                    composition: {
+                        ...recommendation.composition,
+                        enforcement: strategy.adjustment.enforcementBias,
+                    },
+                };
+                adjustmentReasons.push(`Enforcement set to ${strategy.adjustment.enforcementBias}`);
+            }
+        }
+        // Clamp confidence
+        adjustedConfidence = Math.max(0.1, Math.min(0.95, adjustedConfidence));
+        return {
+            ...recommendation,
+            confidence: adjustedConfidence,
+            reasoning: adjustmentReasons.length > 0
+                ? `${recommendation.reasoning}. Meta-adjustments: ${adjustmentReasons.join('; ')}`
+                : recommendation.reasoning,
+            appliedMetaStrategies: [...recommendation.appliedMetaStrategies, ...strategyNames],
+        };
+    }
+    // === Private helpers ===
+    extractTaskCharacteristics(input) {
+        const characteristics = [];
+        characteristics.push(`domain: ${input.domain}`);
+        characteristics.push(`complexity: ${input.complexity}`);
+        const desc = input.description.toLowerCase();
+        if (desc.includes('refactor'))
+            characteristics.push('refactoring');
+        if (desc.includes('implement') || desc.includes('create'))
+            characteristics.push('new feature');
+        if (desc.includes('test'))
+            characteristics.push('testing');
+        if (desc.includes('bug') || desc.includes('fix'))
+            characteristics.push('bug fix');
+        if (desc.includes('multiple') || desc.includes('across'))
+            characteristics.push('cross-cutting');
+        return characteristics;
+    }
+    analyzeTopologyEffectiveness(observations) {
+        const stats = {};
+        for (const obs of observations) {
+            // Use structured topology field (preferred) with regex fallback for older observations
+            const actualTopology = obs.formation.topologyUsed ??
+                obs.formation.reasoning.match(/topology[:\s]+(\w+)/i)?.[1] ??
+                'unknown';
+            if (!stats[actualTopology]) {
+                stats[actualTopology] = { total: 0, successful: 0, domains: new Set() };
+            }
+            stats[actualTopology].total++;
+            if (obs.outcome.success) {
+                stats[actualTopology].successful++;
+            }
+            // Use structured domain field (preferred) with regex fallback
+            const domain = obs.formation.domain ?? obs.formation.reasoning.match(/domain[:\s]+(\w+)/i)?.[1];
+            if (domain) {
+                stats[actualTopology].domains.add(domain);
+            }
+        }
+        // Convert Set to Array for return
+        const result = {};
+        for (const [k, v] of Object.entries(stats)) {
+            result[k] = { total: v.total, successful: v.successful, domains: [...v.domains] };
+        }
+        return result;
+    }
+    analyzeTeamSizePatterns(observations) {
+        // Check if "too-large" assessments dominate
+        const tooLargeCount = observations.filter((o) => o.compositionEffectiveness.teamSizeAssessment === 'too-large').length;
+        if (tooLargeCount >= 3 && tooLargeCount / observations.length > 0.4) {
+            return createTeamMetaStrategy({
+                name: 'reduce-team-size-frequent-redundancy',
+                condition: {
+                    taskCharacteristics: [],
+                    resourceConstraints: [],
+                    domains: [],
+                },
+                adjustment: {
+                    teamSizeAdjustment: 'decrease',
+                    roleAdjustments: ['Remove optional roles by default'],
+                    coordinationHints: ['Teams frequently have redundant roles; prefer smaller teams'],
+                },
+            });
+        }
+        const tooSmallCount = observations.filter((o) => o.compositionEffectiveness.teamSizeAssessment === 'too-small').length;
+        if (tooSmallCount >= 3 && tooSmallCount / observations.length > 0.4) {
+            return createTeamMetaStrategy({
+                name: 'increase-team-size-frequent-overload',
+                condition: {
+                    taskCharacteristics: [],
+                    resourceConstraints: [],
+                    domains: [],
+                },
+                adjustment: {
+                    teamSizeAdjustment: 'increase',
+                    roleAdjustments: ['Add specialist roles for complex subtasks'],
+                    coordinationHints: ['Teams frequently too small; consider adding roles'],
+                },
+            });
+        }
+        return null;
+    }
+    analyzeOverheadPatterns(observations) {
+        const highOverhead = observations.filter((o) => o.coordinationEffectiveness.coordinationOverhead > this.config.highOverheadThreshold);
+        if (highOverhead.length >= 3 && highOverhead.length / observations.length > 0.5) {
+            return createTeamMetaStrategy({
+                name: 'reduce-coordination-overhead',
+                condition: {
+                    taskCharacteristics: [],
+                    resourceConstraints: [],
+                    domains: [],
+                },
+                adjustment: {
+                    teamSizeAdjustment: 'maintain',
+                    enforcementBias: 'permissive',
+                    roleAdjustments: [],
+                    coordinationHints: [
+                        'High coordination overhead detected; use permissive enforcement and fewer channels',
+                    ],
+                },
+            });
+        }
+        return null;
+    }
+}
+/**
+ * Create a TeamMetaLearner instance.
+ */
+export function createTeamMetaLearner(memory, config) {
+    return new TeamMetaLearner(memory, config);
+}
+//# sourceMappingURL=team-meta-learner.js.map

package/dist/experimental/team/team-meta-learner.js.map

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

package/dist/experimental/team/team-meta.d.ts

@@ -0,0 +1,160 @@
+/**
+ * Team Meta-Learning Types
+ *
+ * Types for meta-learning about team formation and coordination.
+ * Observes patterns about which team configurations work for which contexts.
+ * The team-level analog of MetaObservation and MetaStrategy.
+ */
+/**
+ * TeamMetaObservation - Records team formation decisions and outcomes.
+ * The team-level analog of MetaObservation.
+ */
+export interface TeamMetaObservation {
+    id: string;
+    /** Source team trajectory */
+    teamTrajectoryId: string;
+    formation: FormationObservation;
+    compositionEffectiveness: CompositionObservation;
+    coordinationEffectiveness: CoordinationObservation;
+    outcome: TeamOutcomeObservation;
+    lessons: TeamLessonsLearned;
+    timestamp: Date;
+}
+/**
+ * How the team was formed and why.
+ */
+export interface FormationObservation {
+    /** Was a team playbook used to form this team? */
+    playbookUsed?: string;
+    /** Was the team formed from a template or ad-hoc? */
+    formationMethod: 'template' | 'playbook' | 'manual' | 'adaptive';
+    /** Confidence in the formation decision */
+    confidence: number;
+    /** Reasoning for formation choice */
+    reasoning: string;
+    /** Whether the formation was effective (DESIGN doc field) */
+    wasEffective?: boolean;
+    /** Topology type used (stored for reliable extraction in meta-learner) */
+    topologyUsed?: 'hierarchical' | 'flat' | 'wave' | 'custom';
+    /** Domain of the task */
+    domain?: string;
+}
+/**
+ * How effective was the team composition?
+ */
+export interface CompositionObservation {
+    /** Were all roles utilized? */
+    roleUtilization: Record<string, number>;
+    /** Were any roles missing that would have helped? */
+    missingRoles: string[];
+    /** Were any roles redundant? */
+    redundantRoles: string[];
+    /** Was team size appropriate? */
+    teamSizeAssessment: 'too-small' | 'right-sized' | 'too-large';
+    /** Was the topology appropriate? */
+    topologyAssessment: 'effective' | 'neutral' | 'hindering';
+}
+/**
+ * How effective was the coordination?
+ */
+export interface CoordinationObservation {
+    /** Was enforcement mode appropriate? */
+    enforcementAssessment: 'too-strict' | 'appropriate' | 'too-loose';
+    /** Were communication channels well-defined? */
+    channelEffectiveness: 'helpful' | 'neutral' | 'noisy';
+    /** Were there coordination bottlenecks? */
+    bottlenecks: string[];
+    /** Actual coordination overhead ratio */
+    coordinationOverhead: number;
+}
+/**
+ * Team outcome assessment.
+ */
+export interface TeamOutcomeObservation {
+    success: boolean;
+    quality: 'excellent' | 'good' | 'acceptable' | 'poor';
+    /** Was this faster than a single agent would have been? (estimated) */
+    speedupEstimate: number;
+    /** Cost efficiency: quality / tokens */
+    costEfficiency: number;
+}
+/**
+ * Lessons about team formation and coordination.
+ */
+export interface TeamLessonsLearned {
+    /** What team patterns worked */
+    whatWorked: string[];
+    /** What team patterns didn't work */
+    whatFailed: string[];
+    /** Suggestions for future team formation */
+    formationSuggestions: string[];
+    /** Suggestions for future coordination */
+    coordinationSuggestions: string[];
+    /** Role-specific suggestions (DESIGN doc field) */
+    roleSuggestions?: string[];
+}
+/**
+ * TeamMetaStrategy - Learned patterns about team formation.
+ * The team-level analog of MetaStrategy.
+ */
+export interface TeamMetaStrategy {
+    id: string;
+    name: string;
+    /** When to apply this team meta-strategy */
+    condition: TeamMetaCondition;
+    /** What formation/coordination adjustments to make */
+    adjustment: TeamMetaAdjustment;
+    /** Track effectiveness */
+    applicationCount: number;
+    successRate: number;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * Conditions for applying a team meta-strategy.
+ */
+export interface TeamMetaCondition {
+    /** Task characteristics that trigger this strategy */
+    taskCharacteristics: string[];
+    /** Available resources */
+    resourceConstraints: string[];
+    /** Domain context */
+    domains: string[];
+}
+/**
+ * Adjustments to team formation and coordination.
+ */
+export interface TeamMetaAdjustment {
+    /** Topology recommendation */
+    topologyBias?: Record<string, number>;
+    /** Team size adjustment */
+    teamSizeAdjustment: 'increase' | 'decrease' | 'maintain';
+    /** Role adjustments */
+    roleAdjustments: string[];
+    /** Coordination hints */
+    coordinationHints: string[];
+    /** Enforcement mode recommendation */
+    enforcementBias?: 'strict' | 'permissive' | 'audit';
+}
+/**
+ * Create a new team meta-observation.
+ */
+export declare function createTeamMetaObservation(params: {
+    id?: string;
+    teamTrajectoryId: string;
+    formation: FormationObservation;
+    compositionEffectiveness: CompositionObservation;
+    coordinationEffectiveness: CoordinationObservation;
+    outcome: TeamOutcomeObservation;
+    lessons: TeamLessonsLearned;
+}): TeamMetaObservation;
+/**
+ * Create a new team meta-strategy.
+ */
+export declare function createTeamMetaStrategy(params: {
+    id?: string;
+    name: string;
+    condition: TeamMetaCondition;
+    adjustment: TeamMetaAdjustment;
+}): TeamMetaStrategy;
+//# sourceMappingURL=team-meta.d.ts.map

package/dist/experimental/team/team-meta.d.ts.map

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

package/dist/experimental/team/team-meta.js

@@ -0,0 +1,42 @@
+/**
+ * Team Meta-Learning Types
+ *
+ * Types for meta-learning about team formation and coordination.
+ * Observes patterns about which team configurations work for which contexts.
+ * The team-level analog of MetaObservation and MetaStrategy.
+ */
+// ============================================================
+// Factory functions
+// ============================================================
+/**
+ * Create a new team meta-observation.
+ */
+export function createTeamMetaObservation(params) {
+    return {
+        id: params.id ?? crypto.randomUUID(),
+        teamTrajectoryId: params.teamTrajectoryId,
+        formation: params.formation,
+        compositionEffectiveness: params.compositionEffectiveness,
+        coordinationEffectiveness: params.coordinationEffectiveness,
+        outcome: params.outcome,
+        lessons: params.lessons,
+        timestamp: new Date(),
+    };
+}
+/**
+ * Create a new team meta-strategy.
+ */
+export function createTeamMetaStrategy(params) {
+    const now = new Date();
+    return {
+        id: params.id ?? crypto.randomUUID(),
+        name: params.name,
+        condition: params.condition,
+        adjustment: params.adjustment,
+        applicationCount: 0,
+        successRate: 0,
+        createdAt: now,
+        updatedAt: now,
+    };
+}
+//# sourceMappingURL=team-meta.js.map

package/dist/experimental/team/team-meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-meta.js","sourceRoot":"","sources":["../../../src/experimental/team/team-meta.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA6JH,+DAA+D;AAC/D,oBAAoB;AACpB,+DAA+D;AAE/D;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAQzC;IACC,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,EAAE,IAAI,MAAM,CAAC,UAAU,EAAE;QACpC,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;QACzC,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,wBAAwB,EAAE,MAAM,CAAC,wBAAwB;QACzD,yBAAyB,EAAE,MAAM,CAAC,yBAAyB;QAC3D,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,SAAS,EAAE,IAAI,IAAI,EAAE;KACtB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAKtC;IACC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,EAAE,IAAI,MAAM,CAAC,UAAU,EAAE;QACpC,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,gBAAgB,EAAE,CAAC;QACnB,WAAW,EAAE,CAAC;QACd,SAAS,EAAE,GAAG;QACd,SAAS,EAAE,GAAG;KACf,CAAC;AACJ,CAAC"}