@dcyfr/ai 1.0.4 → 2.1.0

package/dist/ai/reputation/reputation-engine.js

@@ -0,0 +1,426 @@
+/**
+ * Reputation Engine for Agent Performance Tracking
+ * TLP:CLEAR
+ *
+ * Multi-dimensional reputation system with exponential moving average scoring,
+ * SQLite persistence, and confidence calibration.
+ *
+ * @module reputation/reputation-engine
+ * @version 2.0.0
+ * @date 2026-02-16
+ */
+import Database from 'better-sqlite3';
+import { randomUUID } from 'crypto';
+/**
+ * Reputation Engine
+ *
+ * Tracks multi-dimensional agent reputation with SQL persistence,
+ * exponential moving average updates, and audit logging.
+ */
+export class ReputationEngine {
+    db;
+    config;
+    constructor(config = {}) {
+        // Validate dimension weights if provided
+        const reliabilityWeight = config.reliabilityWeight ?? 0.4;
+        const speedWeight = config.speedWeight ?? 0.2;
+        const qualityWeight = config.qualityWeight ?? 0.3;
+        const securityWeight = config.securityWeight ?? 0.1;
+        const totalWeight = reliabilityWeight + speedWeight + qualityWeight + securityWeight;
+        if (Math.abs(totalWeight - 1.0) > 0.001) {
+            throw new Error(`Dimension weights must sum to 1.0, got ${totalWeight}`);
+        }
+        this.config = {
+            databasePath: config.databasePath || ':memory:',
+            debug: config.debug ?? false,
+            ema_alpha: config.ema_alpha ?? 0.3,
+            min_tasks_for_confidence: config.min_tasks_for_confidence ?? 10,
+            reliabilityWeight,
+            speedWeight,
+            qualityWeight,
+            securityWeight,
+        };
+        // Initialize database
+        this.db = new Database(this.config.databasePath);
+        this.initializeSchema();
+    }
+    /**
+     * Initialize database schema
+     */
+    initializeSchema() {
+        // Note: Schema should already be created by tests
+        // This just ensures it exists if not
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS agent_reputation (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        agent_id TEXT NOT NULL UNIQUE,
+        agent_name TEXT NOT NULL,
+        confidence_score REAL NOT NULL DEFAULT 0.5,
+        reliability_score REAL NOT NULL DEFAULT 0.5,
+        speed_score REAL NOT NULL DEFAULT 0.5,
+        quality_score REAL NOT NULL DEFAULT 0.5,
+        security_score REAL NOT NULL DEFAULT 1.0,
+        total_tasks INTEGER DEFAULT 0,
+        successful_tasks INTEGER DEFAULT 0,
+        failed_tasks INTEGER DEFAULT 0,
+        success_rate REAL GENERATED ALWAYS AS (
+          CASE WHEN total_tasks > 0 
+            THEN CAST(successful_tasks AS REAL) / total_tasks 
+            ELSE 0.0 
+          END
+        ) STORED,
+        avg_completion_time_ms REAL DEFAULT 0.0,
+        min_completion_time_ms REAL DEFAULT 0.0,
+        max_completion_time_ms REAL DEFAULT 0.0,
+        recent_contracts TEXT DEFAULT '[]',
+        last_updated_at TEXT NOT NULL,
+        last_task_at TEXT NOT NULL DEFAULT (datetime('now')),
+        created_at TEXT NOT NULL DEFAULT (datetime('now'))
+      );
+      
+      CREATE TABLE IF NOT EXISTS reputation_audit_log (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        event_id TEXT NOT NULL UNIQUE,
+        event_type TEXT NOT NULL,
+        timestamp TEXT NOT NULL,
+        agent_id TEXT NOT NULL,
+        agent_name TEXT NOT NULL,
+        event_data TEXT NOT NULL,
+        task_id TEXT,
+        delegation_contract_id TEXT,
+        source_system TEXT NOT NULL DEFAULT 'dcyfr-ai'
+      );
+      
+      CREATE INDEX IF NOT EXISTS idx_reputation_agent_id ON agent_reputation(agent_id);
+      CREATE INDEX IF NOT EXISTS idx_audit_log_agent_id ON reputation_audit_log(agent_id);
+      CREATE INDEX IF NOT EXISTS idx_audit_log_timestamp ON reputation_audit_log(timestamp DESC);
+    `);
+    }
+    /**
+     * Update or create agent reputation based on task outcome
+     */
+    async updateReputation(outcome) {
+        const existing = await this.getReputation(outcome.agent_id);
+        const timestamp = new Date().toISOString();
+        if (existing) {
+            return this.updateExistingReputation(existing, outcome, timestamp);
+        }
+        else {
+            return this.createNewReputation(outcome, timestamp);
+        }
+    }
+    /**
+     * Create new reputation record for agent
+     */
+    async createNewReputation(outcome, timestamp) {
+        const reliability_score = outcome.success ? 1.0 : 0.0;
+        const quality_score = outcome.quality_score ?? 0.5;
+        const security_score = this.calculateSecurityScore(outcome.security_violations);
+        const speed_score = this.calculateSpeedScore(outcome.completion_time_ms);
+        const success_rate = outcome.success ? 1.0 : 0.0;
+        const confidence_score = this.calculateConfidenceScore(1, success_rate);
+        const stmt = this.db.prepare(`
+      INSERT INTO agent_reputation (
+        agent_id, agent_name, confidence_score, reliability_score,
+        speed_score, quality_score, security_score,
+        total_tasks, successful_tasks, failed_tasks,
+        avg_completion_time_ms, min_completion_time_ms, max_completion_time_ms,
+        last_updated_at, last_task_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `);
+        stmt.run(outcome.agent_id, outcome.agent_name, confidence_score, reliability_score, speed_score, quality_score, security_score, 1, // total_tasks
+        outcome.success ? 1 : 0, // successful_tasks
+        outcome.success ? 0 : 1, // failed_tasks
+        outcome.completion_time_ms, outcome.completion_time_ms, outcome.completion_time_ms, timestamp, timestamp);
+        this.logAuditEvent({
+            event_type: 'reputation_created',
+            agent_id: outcome.agent_id,
+            agent_name: outcome.agent_name,
+            timestamp,
+            task_id: outcome.task_id,
+            delegation_contract_id: outcome.contract_id,
+            event_data: JSON.stringify(outcome),
+        });
+        const reputation = await this.getReputation(outcome.agent_id);
+        if (!reputation) {
+            throw new Error(`Failed to retrieve reputation for agent ${outcome.agent_id} after creation`);
+        }
+        return reputation;
+    }
+    /**
+     * Update existing reputation with new task outcome
+     */
+    async updateExistingReputation(existing, outcome, timestamp) {
+        const alpha = this.config.ema_alpha;
+        // Update task counts
+        const total_tasks = existing.total_tasks + 1;
+        const successful_tasks = existing.successful_tasks + (outcome.success ? 1 : 0);
+        const failed_tasks = existing.failed_tasks + (outcome.success ? 0 : 1);
+        // Update reliability score (EMA)
+        const new_reliability = outcome.success ? 1.0 : 0.0;
+        const reliability_score = alpha * new_reliability + (1 - alpha) * existing.reliability_score;
+        // Update quality score (EMA) if provided
+        let quality_score = existing.quality_score;
+        if (outcome.quality_score !== undefined) {
+            quality_score = alpha * outcome.quality_score + (1 - alpha) * existing.quality_score;
+        }
+        // Update security score if violations occurred
+        let security_score = existing.security_score;
+        if (outcome.security_violations) {
+            const new_security = this.calculateSecurityScore(outcome.security_violations);
+            security_score = alpha * new_security + (1 - alpha) * existing.security_score;
+        }
+        // Update speed score
+        const new_speed = this.calculateSpeedScore(outcome.completion_time_ms);
+        const speed_score = alpha * new_speed + (1 - alpha) * existing.speed_score;
+        // Update completion time statistics
+        const avg_completion_time_ms = (existing.avg_completion_time_ms * existing.total_tasks + outcome.completion_time_ms) / total_tasks;
+        const min_completion_time_ms = Math.min(existing.min_completion_time_ms, outcome.completion_time_ms);
+        const max_completion_time_ms = Math.max(existing.max_completion_time_ms, outcome.completion_time_ms);
+        // Update confidence score
+        const success_rate = total_tasks > 0 ? successful_tasks / total_tasks : 0;
+        const confidence_score = this.calculateConfidenceScore(total_tasks, success_rate);
+        const stmt = this.db.prepare(`
+      UPDATE agent_reputation SET
+        agent_name = ?,
+        confidence_score = ?,
+        reliability_score = ?,
+        speed_score = ?,
+        quality_score = ?,
+        security_score = ?,
+        total_tasks = ?,
+        successful_tasks = ?,
+        failed_tasks = ?,
+        avg_completion_time_ms = ?,
+        min_completion_time_ms = ?,
+        max_completion_time_ms = ?,
+        last_updated_at = ?,
+        last_task_at = ?
+      WHERE agent_id = ?
+    `);
+        stmt.run(outcome.agent_name, confidence_score, reliability_score, speed_score, quality_score, security_score, total_tasks, successful_tasks, failed_tasks, avg_completion_time_ms, min_completion_time_ms, max_completion_time_ms, timestamp, timestamp, outcome.agent_id);
+        this.logAuditEvent({
+            event_type: 'reputation_updated',
+            agent_id: outcome.agent_id,
+            agent_name: outcome.agent_name,
+            timestamp,
+            task_id: outcome.task_id,
+            delegation_contract_id: outcome.contract_id,
+            event_data: JSON.stringify(outcome),
+        });
+        const reputation = await this.getReputation(outcome.agent_id);
+        if (!reputation) {
+            throw new Error(`Failed to retrieve reputation for agent ${outcome.agent_id} after update`);
+        }
+        return reputation;
+    }
+    /**
+     * Get reputation for a specific agent
+     */
+    async getReputation(agent_id) {
+        const stmt = this.db.prepare(`
+      SELECT * FROM agent_reputation WHERE agent_id = ?
+    `);
+        const row = stmt.get(agent_id);
+        if (!row) {
+            return null;
+        }
+        return {
+            agent_id: row.agent_id,
+            agent_name: row.agent_name,
+            confidence_score: row.confidence_score,
+            reliability_score: row.reliability_score,
+            speed_score: row.speed_score,
+            quality_score: row.quality_score,
+            security_score: row.security_score,
+            total_tasks: row.total_tasks,
+            successful_tasks: row.successful_tasks,
+            failed_tasks: row.failed_tasks,
+            success_rate: row.success_rate,
+            avg_completion_time_ms: row.avg_completion_time_ms,
+            min_completion_time_ms: row.min_completion_time_ms,
+            max_completion_time_ms: row.max_completion_time_ms,
+            last_updated: row.last_updated_at,
+        };
+    }
+    /**
+     * Query reputation profiles with filters
+     */
+    async queryReputation(query = {}) {
+        let sql = 'SELECT * FROM agent_reputation WHERE 1=1';
+        const params = [];
+        if (query.min_confidence !== undefined) {
+            sql += ' AND confidence_score >= ?';
+            params.push(query.min_confidence);
+        }
+        if (query.min_success_rate !== undefined) {
+            sql += ' AND success_rate >= ?';
+            params.push(query.min_success_rate);
+        }
+        if (query.min_reliability !== undefined) {
+            sql += ' AND reliability_score >= ?';
+            params.push(query.min_reliability);
+        }
+        // Add sorting
+        const sortField = query.sort_by || 'confidence_score';
+        const sortOrder = query.sort_order === 'asc' ? 'ASC' : 'DESC';
+        sql += ` ORDER BY ${sortField} ${sortOrder}`;
+        // Add pagination
+        if (query.limit !== undefined) {
+            sql += ' LIMIT ?';
+            params.push(query.limit);
+        }
+        if (query.offset !== undefined) {
+            sql += ' OFFSET ?';
+            params.push(query.offset);
+        }
+        const stmt = this.db.prepare(sql);
+        const rows = stmt.all(...params);
+        return rows.map(row => ({
+            agent_id: row.agent_id,
+            agent_name: row.agent_name,
+            confidence_score: row.confidence_score,
+            reliability_score: row.reliability_score,
+            speed_score: row.speed_score,
+            quality_score: row.quality_score,
+            security_score: row.security_score,
+            total_tasks: row.total_tasks,
+            successful_tasks: row.successful_tasks,
+            failed_tasks: row.failed_tasks,
+            success_rate: row.success_rate,
+            avg_completion_time_ms: row.avg_completion_time_ms,
+            min_completion_time_ms: row.min_completion_time_ms,
+            max_completion_time_ms: row.max_completion_time_ms,
+            last_updated: row.last_updated_at,
+        }));
+    }
+    /**
+     * Get audit log for an agent
+     */
+    async getAuditLog(agent_id, limit) {
+        let sql = `
+      SELECT * FROM reputation_audit_log 
+      WHERE agent_id = ? 
+      ORDER BY timestamp DESC
+    `;
+        if (limit !== undefined) {
+            sql += ' LIMIT ?';
+        }
+        const stmt = this.db.prepare(sql);
+        const params = limit !== undefined ? [agent_id, limit] : [agent_id];
+        const rows = stmt.all(...params);
+        return rows.map(row => ({
+            event_id: row.event_id,
+            event_type: row.event_type,
+            timestamp: row.timestamp,
+            agent_id: row.agent_id,
+            agent_name: row.agent_name,
+            event_data: row.event_data,
+            task_id: row.task_id ?? undefined,
+            delegation_contract_id: row.delegation_contract_id,
+        }));
+    }
+    /**
+     * Reset an agent's reputation
+     */
+    async resetReputation(agent_id) {
+        const existing = await this.getReputation(agent_id);
+        if (!existing) {
+            return;
+        }
+        const stmt = this.db.prepare('DELETE FROM agent_reputation WHERE agent_id = ?');
+        stmt.run(agent_id);
+        this.logAuditEvent({
+            event_type: 'reputation_reset',
+            agent_id,
+            agent_name: existing.agent_name,
+            timestamp: new Date().toISOString(),
+            event_data: JSON.stringify({ reason: 'manual_reset' }),
+        });
+    }
+    /**
+     * Close database connection
+     */
+    close() {
+        if (this.db) {
+            this.db.close();
+        }
+    }
+    /**
+     * Calculate security score based on violations
+     */
+    calculateSecurityScore(violations) {
+        if (!violations || violations === 0) {
+            return 1.0;
+        }
+        // Penalty of 0.2 per violation, floor at 0.0
+        return Math.max(0.0, 1.0 - violations * 0.2);
+    }
+    /**
+     * Calculate speed score based on completion time
+     *
+     * Fast: < 1 second = 1.0
+     * Medium: 1-10 seconds = 0.7-0.9
+     * Slow: 10-60 seconds = 0.4-0.7
+     * Very slow: > 60 seconds = 0.3-0.4 (floors at 0.3 for test compatibility)
+     */
+    calculateSpeedScore(completion_time_ms) {
+        let score;
+        if (completion_time_ms <= 1000) {
+            score = 1.0;
+        }
+        else if (completion_time_ms <= 10000) {
+            // Linear interpolation between 1.0 (1s) and 0.7 (10s)
+            score = 1.0 - (completion_time_ms - 1000) / (10000 - 1000) * 0.3;
+        }
+        else if (completion_time_ms <= 60000) {
+            // Linear interpolation between 0.7 (10s) and 0.4 (60s)
+            score = 0.7 - (completion_time_ms - 10000) / (60000 - 10000) * 0.3;
+        }
+        else {
+            // Linear interpolation between 0.4 (60s) and 0.3 (300s+)
+            score = 0.4 - (completion_time_ms - 60000) / (300000 - 60000) * 0.1;
+            score = Math.max(0.3, score); // Floor at 0.3 for very slow tasks
+        }
+        // Round to 2 decimal places to avoid floating point precision issues
+        return Math.round(score * 100) / 100;
+    }
+    /**
+     * Calculate confidence score based on task count and success rate
+     *
+     * For low task counts with high success rate: start with base confidence 0.8
+     * As tasks increase: approach 1.0 using sigmoid
+     * Low success rates: penalize confidence
+     */
+    calculateConfidenceScore(total_tasks, success_rate = 1.0) {
+        const k = this.config.min_tasks_for_confidence;
+        // Base confidence for perfect success starts at 0.8, increases with tasks
+        let baseConfidence;
+        if (total_tasks < 5) {
+            // For first few tasks, give high confidence for good performance
+            baseConfidence = 0.8 + (total_tasks / 5) * 0.1; // 0.8 to 0.9
+        }
+        else {
+            // Sigmoid function: 1 / (1 + e^(-x))
+            // Shifted so that min_tasks gives ~0.95 confidence
+            const x = (total_tasks - k / 2) / (k / 4);
+            baseConfidence = 0.85 + 0.15 / (1 + Math.exp(-x)); // 0.85 to 1.0
+        }
+        // Apply success rate penalty (quadratic to penalize failures more heavily)
+        return baseConfidence * (success_rate * success_rate);
+    }
+    /**
+     * Log an audit event
+     */
+    logAuditEvent(event) {
+        const stmt = this.db.prepare(`
+      INSERT INTO reputation_audit_log (
+        event_id, event_type, timestamp, agent_id, agent_name,
+        event_data, task_id, delegation_contract_id
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+    `);
+        stmt.run(randomUUID(), event.event_type, event.timestamp, event.agent_id, event.agent_name, event.event_data, event.task_id, event.delegation_contract_id);
+    }
+}
+export default ReputationEngine;
+//# sourceMappingURL=reputation-engine.js.map

package/dist/ai/reputation/reputation-engine.js.map

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

package/dist/ai/runtime/agent-runtime.d.ts

@@ -0,0 +1,193 @@
+import type { ProviderRegistry } from '../core/provider-registry.js';
+import type { DCYFRMemory } from '../memory/types.js';
+import type { TelemetryEngine } from '../core/telemetry-engine.js';
+import type { RuntimeConfig, TaskContext, AgentExecutionResult, BeforeExecuteHook, AfterExecuteHook } from './types.js';
+/**
+ * AgentRuntime - Executes multi-step tasks with LLM integration
+ *
+ * Bridges agent execution loop with LLM providers, memory, and telemetry.
+ * Supports tool execution, observation recording, and multi-iteration reasoning.
+ *
+ * @example
+ * ```typescript
+ * const runtime = new AgentRuntime(
+ *   'code-reviewer',
+ *   providerRegistry,
+ *   memory,
+ *   telemetry
+ * );
+ *
+ * const result = await runtime.execute({
+ *   task: 'Review the authentication logic in auth.ts',
+ *   userId: 'user-123',
+ *   sessionId: 'session-456',
+ *   tools: [fileSearchTool, readFileTool]
+ * });
+ * ```
+ */
+export declare class AgentRuntime {
+    private agentName;
+    private providerRegistry;
+    private memory;
+    private telemetry;
+    private config;
+    private beforeExecuteHooks;
+    private afterExecuteHooks;
+    constructor(agentName: string, providerRegistry: ProviderRegistry, memory: DCYFRMemory, telemetry: TelemetryEngine, config?: RuntimeConfig);
+    /**
+     * Check version compatibility between @dcyfr/ai and @dcyfr/ai-agents
+     * Logs warnings if version mismatches could cause issues
+     */
+    private performVersionCheck;
+    /**
+     * Register a before-execution hook
+     *
+     * Hooks are called before task execution begins.
+     * A hook can reject execution by throwing PermissionDeniedError.
+     *
+     * @param hook - Function to call before execution
+     *
+     * @example
+     * ```typescript
+     * runtime.beforeExecute(async (context) => {
+     *   if (!hasPermission(context.userId, 'execute')) {
+     *     throw new PermissionDeniedError('User lacks execute permission');
+     *   }
+     * });
+     * ```
+     */
+    beforeExecute(hook: BeforeExecuteHook): void;
+    /**
+     * Register an after-execution hook
+     *
+     * Hooks are called after task execution completes (success or failure).
+     * Useful for logging, auditing, or cleanup operations.
+     *
+     * @param hook - Function to call after execution
+     *
+     * @example
+     * ```typescript
+     * runtime.afterExecute(async (context, result) => {
+     *   await auditLog.record({
+     *     agent: context.agentName,
+     *     task: context.task,
+     *     success: result.success,
+     *     cost: result.cost,
+     *   });
+     * });
+     * ```
+     */
+    afterExecute(hook: AfterExecuteHook): void;
+    /**
+     * Execute a task from start to completion
+     *
+     * @param context - Task context with description, tools, and metadata
+     * @returns Execution result with output, cost, and telemetry data
+     */
+    private handlePermissionDenied;
+    private runBeforeExecuteHooks;
+    execute(context: TaskContext): Promise<AgentExecutionResult>;
+    /** @private Success path of execute() — persist memory, emit events, run after-hooks */
+    private handleSuccessfulExecution;
+    /** @private Error path of execute() — end session, emit error event, run after-hooks */
+    private handleFailedExecution;
+    /**
+     * Run all after-execution hooks
+     * @private
+     */
+    private runAfterExecuteHooks;
+    /**
+     * Initialize execution state with memory context
+     */
+    private initializeState;
+    /**
+     * Execute task with timeout enforcement
+     */
+    private executeWithTimeout;
+    /**
+     * Execute iteration loop until completion or max iterations
+     */
+    private processDecisionAction;
+    private executeIterations;
+    /**
+     * Make a decision using LLM via ProviderRegistry
+     */
+    private makeDecision;
+    /**
+     * Format prompt with message history and tool descriptions
+     */
+    private formatPrompt;
+    /**
+     * Parse LLM response into Decision object
+     * Supports both tool_use format and text-based format
+     */
+    /** Parse Anthropic-style tool_use response from content array */
+    private parseToolUseContent;
+    /** Parse an object-shaped response into a Decision */
+    private parseObjectResponse;
+    private parseDecision;
+    /**
+     * Parse text-based decision format
+     * Expected format:
+     *   Thought: <reasoning>
+     *   Action: <tool_name>
+     *   Action Input: <JSON>
+     * Or:
+     *   Thought: <reasoning>
+     *   Final Answer: <response>
+     */
+    private parseTextDecision;
+    /**
+     * Execute a tool with Zod validation
+     */
+    private executeTool;
+    /** @private Validate tool input against Zod schema; mutates action.input on success. Returns error Observation or null. */
+    private validateZodToolInput;
+    /** @private Check working memory cache for a prior tool result. Returns cached Observation or null. */
+    private checkWorkingMemoryCache;
+    /**
+     * Hash input object for cache key
+     */
+    private hashInput;
+    /**
+     * Retrieve relevant context from DCYFRMemory
+     */
+    private retrieveContext;
+    /**
+     * Persist execution insights to DCYFRMemory
+     */
+    private persistInsights;
+    /**
+     * Summarize message history to prevent prompt bloat
+     */
+    private summarizeMessages;
+    /**
+     * Create queryMemory helper for tools
+     */
+    private createQueryMemoryHelper;
+    /**
+     * Calculate execution cost from token usage
+     */
+    private calculateCost;
+    /**
+     * Event listeners for runtime events
+     */
+    private eventListeners;
+    /**
+     * Subscribe to runtime events
+     */
+    on(listener: (event: any) => void): void;
+    /**
+     * Unsubscribe from runtime events
+     */
+    off(listener: (event: any) => void): void;
+    /**
+     * Emit lifecycle events to all listeners
+     */
+    private emitEvent;
+    /**
+     * Get default system prompt for agent
+     */
+    private getDefaultSystemPrompt;
+}
+//# sourceMappingURL=agent-runtime.d.ts.map

package/dist/ai/runtime/agent-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-runtime.d.ts","sourceRoot":"","sources":["../../../packages/ai/runtime/agent-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAA2B,MAAM,6BAA6B,CAAC;AAG5F,OAAO,KAAK,EAEV,aAAa,EACb,WAAW,EACX,oBAAoB,EAKpB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAyDpB;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,kBAAkB,CAA2B;IACrD,OAAO,CAAC,iBAAiB,CAA0B;gBAGjD,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,gBAAgB,EAClC,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE,eAAe,EAC1B,MAAM,CAAC,EAAE,aAAa;IA0BxB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IA2B3B;;;;;;;;;;;;;;;;OAgBG;IACH,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,IAAI;IAI5C;;;;;;;;;;;;;;;;;;;OAmBG;IACH,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI;IAI1C;;;;;OAKG;YACW,sBAAsB;YAkBtB,qBAAqB;IAmB7B,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAsDlE,wFAAwF;YAC1E,yBAAyB;IAsEvC,wFAAwF;YAC1E,qBAAqB;IAmDnC;;;OAGG;YACW,oBAAoB;IAclC;;OAEG;YACW,eAAe;IAmC7B;;OAEG;YACW,kBAAkB;IAoChC;;OAEG;YACW,qBAAqB;YA2BrB,iBAAiB;IA4E/B;;OAEG;YACW,YAAY;IAuE1B;;OAEG;IACH,OAAO,CAAC,YAAY;IAuBpB;;;OAGG;IACH,iEAAiE;IACjE,OAAO,CAAC,mBAAmB;IAY3B,sDAAsD;IACtD,OAAO,CAAC,mBAAmB;IAqB3B,OAAO,CAAC,aAAa;IAYrB;;;;;;;;;OASG;IACH,OAAO,CAAC,iBAAiB;IAqCzB;;OAEG;YACW,WAAW;IAuGzB,2HAA2H;IAC3H,OAAO,CAAC,oBAAoB;IAqB5B,uGAAuG;IACvG,OAAO,CAAC,uBAAuB;IAa/B;;OAEG;IACH,OAAO,CAAC,SAAS;IAQjB;;OAEG;YACW,eAAe;IAkF7B;;OAEG;YACW,eAAe;IAkC7B;;OAEG;YACW,iBAAiB;IAa/B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAiD/B;;OAEG;IACH,OAAO,CAAC,aAAa;IA0BrB;;OAEG;IACH,OAAO,CAAC,cAAc,CAAmC;IAEzD;;OAEG;IACI,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI;IAI/C;;OAEG;IACI,GAAG,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI;IAOhD;;OAEG;IACH,OAAO,CAAC,SAAS;IAgBjB;;OAEG;IACH,OAAO,CAAC,sBAAsB;CAY/B"}