cognitive-core 0.0.2 → 0.1.2

package/dist/search/solver.js.map

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

package/dist/search/team-router.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Team Router
+ *
+ * Recommends team composition for a given task description.
+ * Queries team playbooks and experiences from memory, scores matches,
+ * and applies team meta-strategies to adjust recommendations.
+ *
+ * The team-level analog of TaskRouter.
+ */
+import type { TeamPlaybook, RolePlaybook, TeamCompositionGuidance, TeamCoordinationGuidance } from '../types/index.js';
+import type { TeamExperienceMemory } from '../memory/team-experience.js';
+import type { TeamMetaLearner } from '../learning/team-meta-learner.js';
+export interface TeamRouterConfig {
+    /** Minimum playbook confidence to use directly */
+    minPlaybookConfidence: number;
+    /** How many playbook candidates to retrieve */
+    maxCandidates: number;
+    /** How many role playbooks to include per role */
+    maxRolePlaybooksPerRole: number;
+    /** Whether to include similar experiences in reasoning */
+    includeSimilarExperiences: boolean;
+}
+/**
+ * Result from team recommendation.
+ */
+export interface TeamRecommendation {
+    /** Matched team playbook (if any) */
+    playbook?: TeamPlaybook;
+    /** Recommended composition */
+    composition: TeamCompositionGuidance;
+    /** Recommended coordination */
+    coordination: TeamCoordinationGuidance;
+    /** Role playbooks for each recommended role */
+    rolePlaybooks: RolePlaybook[];
+    /** Confidence in this recommendation (0-1) */
+    confidence: number;
+    /** Reasoning for this recommendation */
+    reasoning: string;
+    /** Meta-strategies that were applied */
+    appliedMetaStrategies: string[];
+    /** Export as OpenTeams team.yaml format */
+    asTeamYaml(): string;
+}
+/**
+ * Task input for team recommendation.
+ */
+export interface TeamRecommendationInput {
+    description: string;
+    domain: string;
+    complexity: 'simple' | 'moderate' | 'complex' | 'epic';
+    constraints?: {
+        maxAgents?: number;
+        maxTokenBudget?: number;
+        preferredTopology?: string;
+    };
+}
+export declare class TeamRouter {
+    private memory;
+    private config;
+    private metaLearner?;
+    constructor(memory: TeamExperienceMemory, config?: Partial<TeamRouterConfig>, metaLearner?: TeamMetaLearner);
+    /**
+     * Set the team meta learner (can be set after construction).
+     */
+    setMetaLearner(metaLearner: TeamMetaLearner): void;
+    /**
+     * Recommend a team composition for a given task.
+     */
+    recommend(input: TeamRecommendationInput): Promise<TeamRecommendation>;
+    /**
+     * Compute base recommendation from playbook matches.
+     */
+    private computeBaseRecommendation;
+    /**
+     * Apply user constraints to the recommendation.
+     */
+    private applyConstraints;
+    /**
+     * Find role playbooks for each role in the recommendation.
+     */
+    private findRolePlaybooks;
+    /**
+     * Update configuration.
+     */
+    updateConfig(config: Partial<TeamRouterConfig>): void;
+}
+/**
+ * Create a TeamRouter instance.
+ */
+export declare function createTeamRouter(memory: TeamExperienceMemory, config?: Partial<TeamRouterConfig>, metaLearner?: TeamMetaLearner): TeamRouter;
+//# sourceMappingURL=team-router.d.ts.map

package/dist/search/team-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-router.d.ts","sourceRoot":"","sources":["../../src/search/team-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,uBAAuB,EACvB,wBAAwB,EAEzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAMxE,MAAM,WAAW,gBAAgB;IAC/B,kDAAkD;IAClD,qBAAqB,EAAE,MAAM,CAAC;IAC9B,+CAA+C;IAC/C,aAAa,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,uBAAuB,EAAE,MAAM,CAAC;IAChC,0DAA0D;IAC1D,yBAAyB,EAAE,OAAO,CAAC;CACpC;AAaD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,qCAAqC;IACrC,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,8BAA8B;IAC9B,WAAW,EAAE,uBAAuB,CAAC;IACrC,+BAA+B;IAC/B,YAAY,EAAE,wBAAwB,CAAC;IACvC,+CAA+C;IAC/C,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,2CAA2C;IAC3C,UAAU,IAAI,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;IACvD,WAAW,CAAC,EAAE;QACZ,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B,CAAC;CACH;AAiKD,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,WAAW,CAAC,CAAkB;gBAGpC,MAAM,EAAE,oBAAoB,EAC5B,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,EAClC,WAAW,CAAC,EAAE,eAAe;IAO/B;;OAEG;IACH,cAAc,CAAC,WAAW,EAAE,eAAe,GAAG,IAAI;IAIlD;;OAEG;IACG,SAAS,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAsC5E;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAyCjC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAgExB;;OAEG;YACW,iBAAiB;IAuB/B;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI;CAGtD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,oBAAoB,EAC5B,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,EAClC,WAAW,CAAC,EAAE,eAAe,GAC5B,UAAU,CAEZ"}

package/dist/search/team-router.js

@@ -0,0 +1,315 @@
+/**
+ * Team Router
+ *
+ * Recommends team composition for a given task description.
+ * Queries team playbooks and experiences from memory, scores matches,
+ * and applies team meta-strategies to adjust recommendations.
+ *
+ * The team-level analog of TaskRouter.
+ */
+const DEFAULT_CONFIG = {
+    minPlaybookConfidence: 0.4,
+    maxCandidates: 5,
+    maxRolePlaybooksPerRole: 2,
+    includeSimilarExperiences: true,
+};
+// ============================================================
+// Default fallback composition
+// ============================================================
+function defaultComposition(input) {
+    // Simple tasks → flat 2-agent team, complex → wave with planner
+    if (input.complexity === 'simple') {
+        return {
+            topology: 'flat',
+            roles: [
+                {
+                    role: 'executor',
+                    rationale: 'Execute the task directly',
+                    capabilities: ['task execution'],
+                    optional: false,
+                    modelTier: 'balanced',
+                    spawnAs: 'root',
+                },
+            ],
+            spawnRules: {},
+            enforcement: 'permissive',
+        };
+    }
+    const roles = [
+        {
+            role: 'planner',
+            rationale: 'Decompose and plan the work',
+            capabilities: ['planning', 'decomposition'],
+            optional: false,
+            modelTier: 'capable',
+            spawnAs: 'root',
+        },
+        {
+            role: 'executor',
+            rationale: 'Execute planned tasks',
+            capabilities: ['task execution'],
+            optional: false,
+            modelTier: 'balanced',
+            spawnAs: 'companion',
+        },
+    ];
+    if (input.complexity === 'complex' || input.complexity === 'epic') {
+        roles.push({
+            role: 'reviewer',
+            rationale: 'Verify completed work',
+            capabilities: ['review', 'verification'],
+            optional: true,
+            modelTier: 'capable',
+            spawnAs: 'on-demand',
+        });
+    }
+    return {
+        topology: input.complexity === 'epic' ? 'hierarchical' : 'wave',
+        roles,
+        spawnRules: { planner: ['executor', 'reviewer'] },
+        enforcement: 'permissive',
+    };
+}
+function defaultCoordination(input) {
+    return {
+        executionModel: input.complexity === 'simple'
+            ? 'sequential'
+            : 'wave-parallel',
+        channels: [],
+        interactionPatterns: [],
+        delegationStrategy: 'auto',
+    };
+}
+// ============================================================
+// YAML export
+// ============================================================
+function compositionToYaml(rec) {
+    const lines = [
+        '# Team configuration generated by cognitive-core',
+        `# Confidence: ${rec.confidence.toFixed(2)}`,
+        '',
+        'team:',
+        `  topology: ${rec.composition.topology}`,
+        `  enforcement: ${rec.composition.enforcement}`,
+        '',
+        '  roles:',
+    ];
+    for (const role of rec.composition.roles) {
+        lines.push(`    - name: ${role.role}`);
+        lines.push(`      rationale: "${role.rationale}"`);
+        lines.push(`      optional: ${role.optional}`);
+        if (role.modelTier) {
+            lines.push(`      model_tier: ${role.modelTier}`);
+        }
+        lines.push(`      spawn_as: ${role.spawnAs}`);
+        if (role.capabilities.length > 0) {
+            lines.push(`      capabilities:`);
+            for (const cap of role.capabilities) {
+                lines.push(`        - ${cap}`);
+            }
+        }
+    }
+    if (Object.keys(rec.composition.spawnRules).length > 0) {
+        lines.push('');
+        lines.push('  spawn_rules:');
+        for (const [parent, children] of Object.entries(rec.composition.spawnRules)) {
+            lines.push(`    ${parent}: [${children.join(', ')}]`);
+        }
+    }
+    lines.push('');
+    lines.push('  coordination:');
+    lines.push(`    execution_model: ${rec.coordination.executionModel}`);
+    lines.push(`    delegation_strategy: ${rec.coordination.delegationStrategy}`);
+    if (rec.coordination.channels.length > 0) {
+        lines.push('    channels:');
+        for (const ch of rec.coordination.channels) {
+            lines.push(`      - name: ${ch.name}`);
+            lines.push(`        signals: [${ch.signals.join(', ')}]`);
+            lines.push(`        subscribers: [${ch.subscribers.join(', ')}]`);
+            lines.push(`        emitters: [${ch.emitters.join(', ')}]`);
+        }
+    }
+    if (rec.coordination.interactionPatterns.length > 0) {
+        lines.push('    interaction_patterns:');
+        for (const pat of rec.coordination.interactionPatterns) {
+            lines.push(`      - name: ${pat.name}`);
+            lines.push(`        roles: [${pat.roles.join(', ')}]`);
+            lines.push(`        frequency: ${pat.frequency}`);
+        }
+    }
+    if (rec.coordination.checkpoints && rec.coordination.checkpoints.length > 0) {
+        lines.push('    checkpoints:');
+        for (const cp of rec.coordination.checkpoints) {
+            lines.push(`      - ${cp}`);
+        }
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+// ============================================================
+// Team Router
+// ============================================================
+export class TeamRouter {
+    memory;
+    config;
+    metaLearner;
+    constructor(memory, config, metaLearner) {
+        this.memory = memory;
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.metaLearner = metaLearner;
+    }
+    /**
+     * Set the team meta learner (can be set after construction).
+     */
+    setMetaLearner(metaLearner) {
+        this.metaLearner = metaLearner;
+    }
+    /**
+     * Recommend a team composition for a given task.
+     */
+    async recommend(input) {
+        // 1. Find matching team playbooks
+        const playbookMatches = await this.memory.findMatchingTeamPlaybooks({
+            taskType: input.description,
+            domain: input.domain,
+            complexity: input.complexity,
+            topology: input.constraints?.preferredTopology,
+            k: this.config.maxCandidates,
+        });
+        // 2. Compute base recommendation
+        let recommendation = this.computeBaseRecommendation(input, playbookMatches);
+        // 3. Apply constraints
+        recommendation = this.applyConstraints(recommendation, input);
+        // 4. Attach role playbooks for each recommended role
+        const rolePlaybooks = await this.findRolePlaybooks(recommendation, input);
+        recommendation.rolePlaybooks = rolePlaybooks;
+        // 5. Apply meta-learning adjustments
+        if (this.metaLearner) {
+            try {
+                recommendation = await this.metaLearner.adjustRecommendation(recommendation, input);
+            }
+            catch (error) {
+                console.error('[TeamRouter] Meta-learning adjustment failed, using base recommendation:', error instanceof Error ? error.message : String(error));
+            }
+        }
+        return recommendation;
+    }
+    /**
+     * Compute base recommendation from playbook matches.
+     */
+    computeBaseRecommendation(input, playbookMatches) {
+        // Filter to playbooks above minimum confidence
+        const viable = playbookMatches.filter((m) => m.playbook.confidence >= this.config.minPlaybookConfidence);
+        if (viable.length > 0) {
+            // Use the best matching playbook
+            const best = viable[0];
+            const rec = {
+                playbook: best.playbook,
+                composition: best.playbook.composition,
+                coordination: best.playbook.coordination,
+                rolePlaybooks: [],
+                confidence: Math.min(best.score * best.playbook.confidence, 0.95),
+                reasoning: `Matched team playbook "${best.playbook.name}" (score: ${best.score.toFixed(2)}, confidence: ${best.playbook.confidence.toFixed(2)})`,
+                appliedMetaStrategies: [],
+            };
+            return { ...rec, asTeamYaml: () => compositionToYaml(rec) };
+        }
+        // No viable playbook — build a default recommendation
+        const composition = defaultComposition(input);
+        const coordination = defaultCoordination(input);
+        const rec = {
+            composition,
+            coordination,
+            rolePlaybooks: [],
+            confidence: 0.3,
+            reasoning: 'No matching team playbook found; using default composition based on complexity',
+            appliedMetaStrategies: [],
+        };
+        return { ...rec, asTeamYaml: () => compositionToYaml(rec) };
+    }
+    /**
+     * Apply user constraints to the recommendation.
+     */
+    applyConstraints(recommendation, input) {
+        const constraints = input.constraints;
+        if (!constraints)
+            return recommendation;
+        let modified = false;
+        const reasons = [];
+        // Apply max agents constraint
+        if (constraints.maxAgents &&
+            recommendation.composition.roles.length > constraints.maxAgents) {
+            // Keep only essential (non-optional) roles, then trim to fit
+            const essential = recommendation.composition.roles.filter((r) => !r.optional);
+            const optional = recommendation.composition.roles.filter((r) => r.optional);
+            let roles;
+            if (essential.length >= constraints.maxAgents) {
+                roles = essential.slice(0, constraints.maxAgents);
+            }
+            else {
+                const remaining = constraints.maxAgents - essential.length;
+                roles = [...essential, ...optional.slice(0, remaining)];
+            }
+            recommendation = {
+                ...recommendation,
+                composition: { ...recommendation.composition, roles },
+            };
+            reasons.push(`Trimmed to ${constraints.maxAgents} agents`);
+            modified = true;
+        }
+        // Apply preferred topology
+        if (constraints.preferredTopology &&
+            recommendation.composition.topology !== constraints.preferredTopology) {
+            recommendation = {
+                ...recommendation,
+                composition: {
+                    ...recommendation.composition,
+                    topology: constraints.preferredTopology,
+                },
+            };
+            reasons.push(`Topology set to ${constraints.preferredTopology}`);
+            modified = true;
+        }
+        if (modified) {
+            recommendation.reasoning += `. Constraints applied: ${reasons.join('; ')}`;
+            // Slightly lower confidence when constraints override
+            recommendation.confidence = Math.max(0.15, recommendation.confidence * 0.9);
+            // Rebuild asTeamYaml with updated data
+            const rec = recommendation;
+            recommendation.asTeamYaml = () => compositionToYaml(rec);
+        }
+        return recommendation;
+    }
+    /**
+     * Find role playbooks for each role in the recommendation.
+     */
+    async findRolePlaybooks(recommendation, input) {
+        const rolePlaybooks = [];
+        for (const roleSpec of recommendation.composition.roles) {
+            const matches = await this.memory.findMatchingRolePlaybooks({
+                role: roleSpec.role,
+                topology: recommendation.composition.topology,
+                domain: input.domain,
+                taskType: input.description,
+                k: this.config.maxRolePlaybooksPerRole,
+            });
+            for (const match of matches) {
+                rolePlaybooks.push(match.playbook);
+            }
+        }
+        return rolePlaybooks;
+    }
+    /**
+     * Update configuration.
+     */
+    updateConfig(config) {
+        this.config = { ...this.config, ...config };
+    }
+}
+/**
+ * Create a TeamRouter instance.
+ */
+export function createTeamRouter(memory, config, metaLearner) {
+    return new TeamRouter(memory, config, metaLearner);
+}
+//# sourceMappingURL=team-router.js.map

package/dist/search/team-router.js.map

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

package/dist/search/verification-runner.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Verification Runner
+ *
+ * Provides common verification patterns for evaluating solutions:
+ * - Command execution (bash/shell)
+ * - Test runner integration
+ * - Code linting/type checking
+ * - Custom verification functions
+ *
+ * Used with SolutionEvaluator to verify trajectory outcomes.
+ */
+import type { VerificationFunction } from './evaluator.js';
+/**
+ * Configuration for a verification command
+ */
+export interface CommandVerificationConfig {
+    /** Command to run (can include placeholders like {{solution}}, {{taskId}}) */
+    command: string;
+    /** Working directory for the command */
+    cwd?: string;
+    /** Environment variables to set */
+    env?: Record<string, string>;
+    /** Timeout in milliseconds (default: 30000) */
+    timeout?: number;
+    /** Whether exit code 0 indicates success (default: true) */
+    successOnZeroExit?: boolean;
+    /** Pattern to search for in output to indicate success */
+    successPattern?: RegExp;
+    /** Pattern to search for in output to indicate failure */
+    failurePattern?: RegExp;
+    /** Function to extract issues from output */
+    issueExtractor?: (output: string, exitCode: number) => VerificationIssue[];
+}
+/**
+ * Issue found during verification
+ */
+export interface VerificationIssue {
+    type: 'incomplete' | 'incorrect' | 'error';
+    description: string;
+    severity?: 'critical' | 'major' | 'minor';
+    line?: number;
+    file?: string;
+}
+/**
+ * Result of running a command
+ */
+export interface CommandResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+    timedOut: boolean;
+}
+/**
+ * Common test runner configurations
+ */
+export declare const TestRunners: {
+    /** Node.js test runners */
+    vitest: (testPath?: string) => CommandVerificationConfig;
+    jest: (testPath?: string) => CommandVerificationConfig;
+    mocha: (testPath?: string) => CommandVerificationConfig;
+    /** Python test runners */
+    pytest: (testPath?: string) => CommandVerificationConfig;
+    /** Go test runner */
+    goTest: (testPath?: string) => CommandVerificationConfig;
+    /** Rust test runner */
+    cargoTest: (testPath?: string) => CommandVerificationConfig;
+    /** TypeScript type checking */
+    typescript: () => CommandVerificationConfig;
+    /** ESLint */
+    eslint: (path?: string) => CommandVerificationConfig;
+};
+/**
+ * VerificationRunner - Executes verification commands and parses results
+ */
+export declare class VerificationRunner {
+    private defaultCwd;
+    private defaultTimeout;
+    private defaultEnv;
+    constructor(options?: {
+        cwd?: string;
+        timeout?: number;
+        env?: Record<string, string>;
+    });
+    /**
+     * Create a verification function from a command configuration
+     */
+    createVerifier(config: CommandVerificationConfig): VerificationFunction;
+    /**
+     * Run a command and capture output
+     */
+    runCommand(command: string, options: {
+        cwd?: string;
+        env?: Record<string, string>;
+        timeout?: number;
+    }): Promise<CommandResult>;
+    /**
+     * Run a command synchronously (for simple checks)
+     */
+    runCommandSync(command: string, options?: {
+        cwd?: string;
+        env?: Record<string, string>;
+        timeout?: number;
+    }): CommandResult;
+    /**
+     * Interpolate command with trajectory/task values
+     */
+    private interpolateCommand;
+    /**
+     * Extract default issues from output
+     */
+    private extractDefaultIssues;
+    /**
+     * Create a composite verifier that runs multiple verifications
+     */
+    createCompositeVerifier(configs: CommandVerificationConfig[]): VerificationFunction;
+}
+/**
+ * Create a verification runner
+ */
+export declare function createVerificationRunner(options?: {
+    cwd?: string;
+    timeout?: number;
+    env?: Record<string, string>;
+}): VerificationRunner;
+//# sourceMappingURL=verification-runner.d.ts.map

package/dist/search/verification-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verification-runner.d.ts","sourceRoot":"","sources":["../../src/search/verification-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,oBAAoB,EAAsB,MAAM,gBAAgB,CAAC;AAG/E;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,0DAA0D;IAC1D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0DAA0D;IAC1D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6CAA6C;IAC7C,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,iBAAiB,EAAE,CAAC;CAC5E;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,YAAY,GAAG,WAAW,GAAG,OAAO,CAAC;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,eAAO,MAAM,WAAW;IACtB,2BAA2B;wBACP,MAAM,KAAG,yBAAyB;sBAOpC,MAAM,KAAG,yBAAyB;uBAOjC,MAAM,KAAG,yBAAyB;IAMrD,0BAA0B;wBACN,MAAM,KAAG,yBAAyB;IAQtD,qBAAqB;wBACD,MAAM,KAAG,yBAAyB;IAOtD,uBAAuB;2BACA,MAAM,KAAG,yBAAyB;IAOzD,+BAA+B;sBACf,yBAAyB;IAOzC,aAAa;oBACG,MAAM,KAAG,yBAAyB;CAMnD,CAAC;AAEF;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,UAAU,CAAyB;gBAE/B,OAAO,CAAC,EAAE;QACpB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAC9B;IAMD;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,yBAAyB,GAAG,oBAAoB;IA4DvE;;OAEG;IACG,UAAU,CACd,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;QACP,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GACA,OAAO,CAAC,aAAa,CAAC;IAqDzB;;OAEG;IACH,cAAc,CACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GACA,aAAa;IA+BhB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAiB1B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAmC5B;;OAEG;IACH,uBAAuB,CACrB,OAAO,EAAE,yBAAyB,EAAE,GACnC,oBAAoB;CA+BxB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,CAAC,EAAE;IACjD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B,GAAG,kBAAkB,CAErB"}