promptspeak-mcp-server 0.1.0

package/dist/swarm/demo/swarm-demo.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Swarm Intelligence End-to-End Demo
+ *
+ * Demonstrates the complete swarm flow:
+ * 1. Process sample eBay listings
+ * 2. Prepare data for Pinecone vector storage
+ * 3. Execute price pattern analysis
+ * 4. Generate bid recommendations using strategies
+ * 5. Output structured results
+ *
+ * Run with: npx tsx src/swarm/demo/swarm-demo.ts
+ */
+import { createSwarmVectorService } from '../vectors/index.js';
+import type { StrategyDecision, MarketContext } from '../strategies/types.js';
+import type { BiddingStrategy, NormalizedListing, Observation, MarketAgentConfig } from '../types.js';
+export interface DemoConfig {
+    /** Budget per agent in USD */
+    agentBudget: number;
+    /** Number of agents to simulate */
+    agentCount: number;
+    /** Whether to enable vector storage (requires PINECONE_API_KEY) */
+    enableVectors: boolean;
+    /** Show detailed output */
+    verbose: boolean;
+}
+export interface StrategyEvaluation {
+    listingId: string;
+    listingTitle: string;
+    strategy: BiddingStrategy;
+    agentId: string;
+    decision: StrategyDecision;
+    marketCondition: string;
+    currentPrice: number;
+    marketAverage?: number;
+    discountPercent?: number;
+}
+export interface VectorPrepResult {
+    listingId: string;
+    listingRecord: unknown;
+    priceRecord: unknown;
+    sellerRecord: unknown;
+}
+export interface DemoResults {
+    /** Timestamp of demo run */
+    timestamp: string;
+    /** Configuration used */
+    config: DemoConfig;
+    /** Listings processed */
+    listingsProcessed: number;
+    /** Vector preparation results (if enabled) */
+    vectorPrep: VectorPrepResult[];
+    /** Strategy evaluations per listing */
+    evaluations: StrategyEvaluation[];
+    /** Aggregated recommendations */
+    recommendations: BidRecommendation[];
+    /** Summary statistics */
+    summary: DemoSummary;
+}
+export interface BidRecommendation {
+    listingId: string;
+    listingTitle: string;
+    recommendedAction: string;
+    recommendedAmount?: number;
+    bestStrategy: BiddingStrategy;
+    confidence: number;
+    reasoning: string;
+    consensusLevel: 'UNANIMOUS' | 'MAJORITY' | 'SPLIT' | 'SINGLE';
+    agreeingAgents: number;
+    totalAgents: number;
+}
+export interface DemoSummary {
+    totalListings: number;
+    recommendedBids: number;
+    recommendedOffers: number;
+    recommendedWatch: number;
+    recommendedSkip: number;
+    avgConfidence: number;
+    underpricedOpportunities: number;
+    fairValueListings: number;
+    overpricedListings: number;
+}
+/**
+ * Run the complete swarm intelligence demo.
+ */
+export declare function runSwarmDemo(config?: Partial<DemoConfig>): Promise<DemoResults>;
+/**
+ * Create demo agent configurations.
+ */
+export declare function createDemoAgents(count: number, budget: number, swarmId: string): MarketAgentConfig[];
+/**
+ * Prepare vector records for a listing.
+ */
+export declare function prepareVectorRecords(vectorService: ReturnType<typeof createSwarmVectorService>, listing: NormalizedListing, observation: Observation): VectorPrepResult;
+/**
+ * Evaluate a listing with all agent strategies.
+ */
+export declare function evaluateWithAllStrategies(listing: NormalizedListing, agents: MarketAgentConfig[], observation: Observation, marketContext?: MarketContext): Promise<StrategyEvaluation[]>;
+/**
+ * Generate a consolidated recommendation from strategy evaluations.
+ */
+export declare function generateRecommendation(listing: NormalizedListing, evaluations: StrategyEvaluation[]): BidRecommendation;
+/**
+ * Calculate summary statistics.
+ */
+export declare function calculateSummary(results: DemoResults): DemoSummary;
+/**
+ * Print summary to console.
+ */
+export declare function printSummary(summary: DemoSummary): void;
+//# sourceMappingURL=swarm-demo.d.ts.map

package/dist/swarm/demo/swarm-demo.d.ts.map

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

package/dist/swarm/demo/swarm-demo.js

@@ -0,0 +1,423 @@
+/**
+ * Swarm Intelligence End-to-End Demo
+ *
+ * Demonstrates the complete swarm flow:
+ * 1. Process sample eBay listings
+ * 2. Prepare data for Pinecone vector storage
+ * 3. Execute price pattern analysis
+ * 4. Generate bid recommendations using strategies
+ * 5. Output structured results
+ *
+ * Run with: npx tsx src/swarm/demo/swarm-demo.ts
+ */
+import { SAMPLE_LISTINGS, SAMPLE_SELLER_PROFILES, getMarketContextForListing, generateSampleObservation, } from './fixtures/index.js';
+import { createSwarmVectorService, } from '../vectors/index.js';
+import { createStrategy, getRecommendedDistribution, } from '../strategies/index.js';
+import { generateAgentId, generateSwarmId, } from '../types.js';
+const DEFAULT_DEMO_CONFIG = {
+    agentBudget: 500,
+    agentCount: 5,
+    enableVectors: false, // Set to true if PINECONE_API_KEY is available
+    verbose: true,
+};
+// =============================================================================
+// DEMO RUNNER
+// =============================================================================
+/**
+ * Run the complete swarm intelligence demo.
+ */
+export async function runSwarmDemo(config = {}) {
+    const finalConfig = { ...DEFAULT_DEMO_CONFIG, ...config };
+    const swarmId = generateSwarmId();
+    console.log('\n' + '='.repeat(80));
+    console.log('SWARM INTELLIGENCE DEMO');
+    console.log('='.repeat(80));
+    console.log(`Swarm ID: ${swarmId}`);
+    console.log(`Timestamp: ${new Date().toISOString()}`);
+    console.log(`Agent Budget: $${finalConfig.agentBudget}`);
+    console.log(`Agent Count: ${finalConfig.agentCount}`);
+    console.log('='.repeat(80) + '\n');
+    // Initialize results
+    const results = {
+        timestamp: new Date().toISOString(),
+        config: finalConfig,
+        listingsProcessed: 0,
+        vectorPrep: [],
+        evaluations: [],
+        recommendations: [],
+        summary: {
+            totalListings: 0,
+            recommendedBids: 0,
+            recommendedOffers: 0,
+            recommendedWatch: 0,
+            recommendedSkip: 0,
+            avgConfidence: 0,
+            underpricedOpportunities: 0,
+            fairValueListings: 0,
+            overpricedListings: 0,
+        },
+    };
+    // Step 1: Create agent configurations
+    console.log('STEP 1: Creating Agent Configurations');
+    console.log('-'.repeat(40));
+    const agents = createDemoAgents(finalConfig.agentCount, finalConfig.agentBudget, swarmId);
+    console.log(`Created ${agents.length} agents with strategies:`);
+    agents.forEach(agent => {
+        console.log(`  - ${agent.agentId}: ${agent.strategy}`);
+    });
+    console.log('');
+    // Step 2: Initialize vector service (optional)
+    console.log('STEP 2: Initializing Vector Service');
+    console.log('-'.repeat(40));
+    const vectorService = createSwarmVectorService({
+        enabled: finalConfig.enableVectors,
+        namespace: 'demo',
+    });
+    if (vectorService.isEnabled()) {
+        console.log('Vector service enabled - will prepare records for Pinecone');
+        console.log(`Indexes: ${Object.values(vectorService.getIndexNames()).join(', ')}`);
+    }
+    else {
+        console.log('Vector service disabled (no PINECONE_API_KEY or enableVectors=false)');
+        console.log('Skipping vector preparation...');
+    }
+    console.log('');
+    // Step 3: Process each listing
+    console.log('STEP 3: Processing Listings');
+    console.log('-'.repeat(40));
+    for (const listing of SAMPLE_LISTINGS) {
+        console.log(`\nProcessing: ${listing.title}`);
+        console.log(`  Item ID: ${listing.itemId}`);
+        console.log(`  Current Price: $${listing.currentPrice.toFixed(2)}`);
+        console.log(`  Type: ${listing.isAuction ? 'Auction' : 'Fixed Price'}${listing.hasBestOffer ? ' + Best Offer' : ''}`);
+        // Get market context
+        const marketContext = getMarketContextForListing(listing);
+        if (marketContext) {
+            console.log(`  Market Avg: $${marketContext.averagePrice.toFixed(2)}`);
+            const discount = ((marketContext.averagePrice - listing.currentPrice) / marketContext.averagePrice) * 100;
+            console.log(`  Discount: ${discount.toFixed(1)}%`);
+        }
+        // Generate observation
+        const observation = generateSampleObservation(listing, agents[0].agentId, swarmId);
+        // Step 3a: Prepare for vector storage
+        if (vectorService.isEnabled()) {
+            const vectorPrep = prepareVectorRecords(vectorService, listing, observation);
+            results.vectorPrep.push(vectorPrep);
+            if (finalConfig.verbose) {
+                console.log('  Vector Records Prepared:');
+                console.log(`    - Listing: ${vectorPrep.listingRecord ? 'Yes' : 'No'}`);
+                console.log(`    - Price: ${vectorPrep.priceRecord ? 'Yes' : 'No'}`);
+                console.log(`    - Seller: ${vectorPrep.sellerRecord ? 'Yes' : 'No'}`);
+            }
+        }
+        // Step 3b: Evaluate with each strategy
+        const listingEvaluations = await evaluateWithAllStrategies(listing, agents, observation, marketContext);
+        results.evaluations.push(...listingEvaluations);
+        if (finalConfig.verbose) {
+            console.log('  Strategy Evaluations:');
+            listingEvaluations.forEach(ev => {
+                console.log(`    ${ev.strategy}: ${ev.decision.action}${ev.decision.amount ? ` ($${ev.decision.amount.toFixed(2)})` : ''} [${(ev.decision.confidence * 100).toFixed(0)}%]`);
+            });
+        }
+        // Step 3c: Generate recommendation
+        const recommendation = generateRecommendation(listing, listingEvaluations);
+        results.recommendations.push(recommendation);
+        console.log(`  RECOMMENDATION: ${recommendation.recommendedAction}${recommendation.recommendedAmount ? ` at $${recommendation.recommendedAmount.toFixed(2)}` : ''}`);
+        console.log(`  Best Strategy: ${recommendation.bestStrategy} (${recommendation.consensusLevel} consensus)`);
+        results.listingsProcessed++;
+    }
+    // Step 4: Generate summary
+    console.log('\n' + '='.repeat(80));
+    console.log('STEP 4: Summary');
+    console.log('='.repeat(80));
+    results.summary = calculateSummary(results);
+    printSummary(results.summary);
+    // Step 5: Show final recommendations
+    console.log('\n' + '='.repeat(80));
+    console.log('FINAL BID RECOMMENDATIONS');
+    console.log('='.repeat(80));
+    const actionableRecs = results.recommendations.filter(r => r.recommendedAction === 'BID' || r.recommendedAction === 'OFFER');
+    if (actionableRecs.length === 0) {
+        console.log('No actionable recommendations at this time.');
+    }
+    else {
+        actionableRecs.forEach((rec, i) => {
+            console.log(`\n${i + 1}. ${rec.listingTitle}`);
+            console.log(`   Action: ${rec.recommendedAction} at $${rec.recommendedAmount?.toFixed(2) || 'N/A'}`);
+            console.log(`   Strategy: ${rec.bestStrategy}`);
+            console.log(`   Confidence: ${(rec.confidence * 100).toFixed(0)}%`);
+            console.log(`   Reasoning: ${rec.reasoning}`);
+        });
+    }
+    console.log('\n' + '='.repeat(80));
+    console.log('Demo Complete!');
+    console.log('='.repeat(80) + '\n');
+    return results;
+}
+// =============================================================================
+// HELPER FUNCTIONS
+// =============================================================================
+/**
+ * Create demo agent configurations.
+ */
+export function createDemoAgents(count, budget, swarmId) {
+    const distribution = getRecommendedDistribution(count);
+    const agents = [];
+    const now = new Date();
+    const end = new Date(now.getTime() + 24 * 60 * 60 * 1000);
+    for (const [strategy, strategyCount] of distribution) {
+        for (let i = 0; i < strategyCount; i++) {
+            agents.push({
+                agentId: generateAgentId(),
+                name: `${strategy}-Agent-${i + 1}`,
+                strategy,
+                budgetAllocation: { value: budget, currency: 'USD' },
+                timeWindow: { start: now, end },
+                targetCriteria: {
+                    searchQuery: 'gold silver bullion',
+                    minPrice: 25,
+                    maxPrice: 3000,
+                    conditions: ['NEW', 'LIKE_NEW'],
+                },
+                swarmId,
+            });
+        }
+    }
+    return agents;
+}
+/**
+ * Prepare vector records for a listing.
+ */
+export function prepareVectorRecords(vectorService, listing, observation) {
+    const listingRecord = vectorService.prepareListingForStorage(listing, observation);
+    const priceRecord = vectorService.preparePriceObservationForStorage(observation);
+    // Find seller profile
+    const sellerProfile = SAMPLE_SELLER_PROFILES.find(s => s.sellerId === listing.sellerId);
+    const sellerRecord = sellerProfile
+        ? vectorService.prepareSellerProfileForStorage(sellerProfile)
+        : null;
+    return {
+        listingId: listing.itemId,
+        listingRecord: listingRecord?.record || null,
+        priceRecord: priceRecord?.record || null,
+        sellerRecord: sellerRecord?.record || null,
+    };
+}
+/**
+ * Evaluate a listing with all agent strategies.
+ */
+export async function evaluateWithAllStrategies(listing, agents, observation, marketContext) {
+    const evaluations = [];
+    for (const agent of agents) {
+        const strategy = createStrategy(agent.strategy);
+        const context = {
+            listing,
+            agentConfig: agent,
+            remainingBudget: agent.budgetAllocation || { value: 500, currency: 'USD' },
+            agentHistory: [],
+            currentTime: new Date(),
+            marketContext,
+        };
+        try {
+            const decision = await strategy.evaluate(context);
+            evaluations.push({
+                listingId: listing.itemId,
+                listingTitle: listing.title,
+                strategy: agent.strategy,
+                agentId: agent.agentId,
+                decision,
+                marketCondition: observation.marketCondition,
+                currentPrice: listing.currentPrice,
+                marketAverage: observation.marketAverage,
+                discountPercent: observation.discountPercent,
+            });
+        }
+        catch (error) {
+            console.error(`Strategy ${agent.strategy} failed:`, error);
+        }
+    }
+    return evaluations;
+}
+/**
+ * Generate a consolidated recommendation from strategy evaluations.
+ */
+export function generateRecommendation(listing, evaluations) {
+    // Count actions
+    const actionCounts = {};
+    evaluations.forEach(ev => {
+        const action = ev.decision.action;
+        if (!actionCounts[action]) {
+            actionCounts[action] = [];
+        }
+        actionCounts[action].push(ev);
+    });
+    // Find majority action
+    let majorityAction = 'SKIP';
+    let majorityCount = 0;
+    for (const [action, evals] of Object.entries(actionCounts)) {
+        if (evals.length > majorityCount) {
+            majorityCount = evals.length;
+            majorityAction = action;
+        }
+    }
+    const majorityEvaluations = actionCounts[majorityAction] || [];
+    // Determine consensus level
+    let consensusLevel;
+    const totalAgents = evaluations.length;
+    if (majorityCount === totalAgents) {
+        consensusLevel = 'UNANIMOUS';
+    }
+    else if (majorityCount > totalAgents / 2) {
+        consensusLevel = 'MAJORITY';
+    }
+    else if (majorityCount > 1) {
+        consensusLevel = 'SPLIT';
+    }
+    else {
+        consensusLevel = 'SINGLE';
+    }
+    // Calculate average amount and confidence from majority
+    let avgAmount;
+    let avgConfidence = 0;
+    const amounts = majorityEvaluations
+        .filter(ev => ev.decision.amount !== undefined)
+        .map(ev => ev.decision.amount);
+    if (amounts.length > 0) {
+        avgAmount = amounts.reduce((a, b) => a + b, 0) / amounts.length;
+    }
+    avgConfidence = majorityEvaluations.reduce((sum, ev) => sum + ev.decision.confidence, 0) / majorityEvaluations.length;
+    // Find best strategy (highest confidence in majority)
+    const bestEval = majorityEvaluations.reduce((best, current) => current.decision.confidence > best.decision.confidence ? current : best, majorityEvaluations[0]);
+    return {
+        listingId: listing.itemId,
+        listingTitle: listing.title,
+        recommendedAction: majorityAction,
+        recommendedAmount: avgAmount,
+        bestStrategy: bestEval.strategy,
+        confidence: avgConfidence,
+        reasoning: bestEval.decision.reasoning,
+        consensusLevel,
+        agreeingAgents: majorityCount,
+        totalAgents,
+    };
+}
+/**
+ * Calculate summary statistics.
+ */
+export function calculateSummary(results) {
+    const summary = {
+        totalListings: results.listingsProcessed,
+        recommendedBids: 0,
+        recommendedOffers: 0,
+        recommendedWatch: 0,
+        recommendedSkip: 0,
+        avgConfidence: 0,
+        underpricedOpportunities: 0,
+        fairValueListings: 0,
+        overpricedListings: 0,
+    };
+    // Count recommendations
+    results.recommendations.forEach(rec => {
+        switch (rec.recommendedAction) {
+            case 'BID':
+                summary.recommendedBids++;
+                break;
+            case 'OFFER':
+                summary.recommendedOffers++;
+                break;
+            case 'WATCH':
+                summary.recommendedWatch++;
+                break;
+            case 'SKIP':
+            case 'DECLINE':
+                summary.recommendedSkip++;
+                break;
+        }
+        summary.avgConfidence += rec.confidence;
+    });
+    if (results.recommendations.length > 0) {
+        summary.avgConfidence /= results.recommendations.length;
+    }
+    // Count market conditions
+    const conditions = new Set(results.evaluations.map(ev => ev.marketCondition));
+    results.evaluations.forEach(ev => {
+        if (ev.marketCondition === 'UNDERPRICED') {
+            summary.underpricedOpportunities++;
+        }
+        else if (ev.marketCondition === 'FAIR') {
+            summary.fairValueListings++;
+        }
+        else if (ev.marketCondition === 'OVERPRICED') {
+            summary.overpricedListings++;
+        }
+    });
+    // Normalize by number of agents (each listing is evaluated by all agents)
+    const agentCount = results.config.agentCount;
+    summary.underpricedOpportunities = Math.round(summary.underpricedOpportunities / agentCount);
+    summary.fairValueListings = Math.round(summary.fairValueListings / agentCount);
+    summary.overpricedListings = Math.round(summary.overpricedListings / agentCount);
+    return summary;
+}
+/**
+ * Print summary to console.
+ */
+export function printSummary(summary) {
+    console.log(`\nTotal Listings: ${summary.totalListings}`);
+    console.log(`\nRecommendations:`);
+    console.log(`  Bids: ${summary.recommendedBids}`);
+    console.log(`  Offers: ${summary.recommendedOffers}`);
+    console.log(`  Watch: ${summary.recommendedWatch}`);
+    console.log(`  Skip: ${summary.recommendedSkip}`);
+    console.log(`\nAvg Confidence: ${(summary.avgConfidence * 100).toFixed(1)}%`);
+    console.log(`\nMarket Analysis:`);
+    console.log(`  Underpriced: ${summary.underpricedOpportunities}`);
+    console.log(`  Fair Value: ${summary.fairValueListings}`);
+    console.log(`  Overpriced: ${summary.overpricedListings}`);
+}
+// =============================================================================
+// CLI RUNNER
+// =============================================================================
+/**
+ * Main entry point for CLI execution.
+ */
+async function main() {
+    try {
+        // Check for command line args
+        const args = process.argv.slice(2);
+        const config = {};
+        args.forEach(arg => {
+            if (arg === '--verbose' || arg === '-v') {
+                config.verbose = true;
+            }
+            if (arg === '--quiet' || arg === '-q') {
+                config.verbose = false;
+            }
+            if (arg === '--vectors') {
+                config.enableVectors = true;
+            }
+            if (arg.startsWith('--agents=')) {
+                config.agentCount = parseInt(arg.split('=')[1], 10);
+            }
+            if (arg.startsWith('--budget=')) {
+                config.agentBudget = parseFloat(arg.split('=')[1]);
+            }
+        });
+        const results = await runSwarmDemo(config);
+        // Output JSON if requested
+        if (args.includes('--json')) {
+            console.log('\nJSON Output:');
+            console.log(JSON.stringify(results, null, 2));
+        }
+    }
+    catch (error) {
+        console.error('Demo failed:', error);
+        process.exit(1);
+    }
+}
+// Run if executed directly
+// Note: Works with both direct node execution and tsx
+const isMainModule = process.argv[1]?.includes('swarm-demo');
+if (isMainModule) {
+    main();
+}
+//# sourceMappingURL=swarm-demo.js.map

package/dist/swarm/demo/swarm-demo.js.map

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

package/dist/swarm/ebay/auth.d.ts

@@ -0,0 +1,98 @@
+/**
+ * eBay OAuth 2.0 Authentication
+ *
+ * Handles OAuth 2.0 authentication flow for eBay APIs,
+ * including token management and refresh.
+ */
+import type { EbayOAuthScope } from './types.js';
+interface StoredToken {
+    accessToken: string;
+    refreshToken?: string;
+    expiresAt: number;
+    refreshExpiresAt?: number;
+    scopes: string[];
+}
+/**
+ * eBay OAuth 2.0 authentication handler.
+ */
+export declare class EbayAuth {
+    private clientId;
+    private clientSecret;
+    private redirectUri;
+    private authBaseUrl;
+    private tokenRefreshBuffer;
+    constructor();
+    /**
+     * Get an application access token using client credentials.
+     * This is for API calls that don't require user authorization.
+     */
+    getApplicationToken(scopes?: EbayOAuthScope[]): Promise<string>;
+    /**
+     * Get the authorization URL for user consent.
+     * Redirect the user to this URL to authorize the application.
+     */
+    getAuthorizationUrl(scopes?: EbayOAuthScope[], state?: string): string;
+    /**
+     * Exchange authorization code for user access token.
+     * Call this after the user is redirected back from eBay.
+     */
+    exchangeAuthorizationCode(code: string): Promise<StoredToken>;
+    /**
+     * Refresh the user access token using the refresh token.
+     */
+    refreshAccessToken(): Promise<string>;
+    /**
+     * Get a valid access token, refreshing if necessary.
+     */
+    getAccessToken(): Promise<string>;
+    /**
+     * Check if token is still valid (not expired).
+     */
+    private isTokenValid;
+    /**
+     * Check if token should be refreshed (approaching expiry).
+     */
+    private tokenNeedsRefresh;
+    /**
+     * Check if we have a user token (vs application token).
+     */
+    hasUserToken(): boolean;
+    /**
+     * Get current token info (for debugging).
+     */
+    getTokenInfo(): {
+        hasToken: boolean;
+        isUserToken: boolean;
+        expiresIn: number | null;
+        scopes: string[];
+    };
+    /**
+     * Clear stored tokens (logout).
+     */
+    clearTokens(): void;
+    /**
+     * Set token from external storage (e.g., database).
+     */
+    setStoredToken(token: StoredToken): void;
+    /**
+     * Get stored token for persistence.
+     */
+    getStoredToken(): StoredToken | null;
+}
+/**
+ * eBay authentication error.
+ */
+export declare class EbayAuthError extends Error {
+    readonly errorData: unknown;
+    constructor(message: string, errorData?: unknown);
+}
+/**
+ * Get the eBay auth singleton.
+ */
+export declare function getEbayAuth(): EbayAuth;
+/**
+ * Initialize eBay auth (validates configuration).
+ */
+export declare function initializeEbayAuth(): Promise<EbayAuth>;
+export {};
+//# sourceMappingURL=auth.d.ts.map

package/dist/swarm/ebay/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/swarm/ebay/auth.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,OAAO,KAAK,EAAkB,cAAc,EAAE,MAAM,YAAY,CAAC;AAMjE,UAAU,WAAW;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAQD;;GAEG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,kBAAkB,CAAkB;;IAc5C;;;OAGG;IACG,mBAAmB,CAAC,MAAM,GAAE,cAAc,EAA6C,GAAG,OAAO,CAAC,MAAM,CAAC;IA4C/G;;;OAGG;IACH,mBAAmB,CACjB,MAAM,GAAE,cAAc,EAAyB,EAC/C,KAAK,CAAC,EAAE,MAAM,GACb,MAAM;IAeT;;;OAGG;IACG,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAuCnE;;OAEG;IACG,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC;IAkD3C;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAmBvC;;OAEG;IACH,OAAO,CAAC,YAAY;IAIpB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB;;OAEG;IACH,YAAY,IAAI;QACd,QAAQ,EAAE,OAAO,CAAC;QAClB,WAAW,EAAE,OAAO,CAAC;QACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB;IAkBD;;OAEG;IACH,WAAW,IAAI,IAAI;IAInB;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAIxC;;OAEG;IACH,cAAc,IAAI,WAAW,GAAG,IAAI;CAGrC;AAMD;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC,SAAgB,SAAS,EAAE,OAAO,CAAC;gBAEvB,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,OAAO;CAKjD;AAQD;;GAEG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAKtC;AAED;;GAEG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,QAAQ,CAAC,CAO5D"}