dino-spec 9.9.0 → 9.10.0

package/README.md

@@ -10,11 +10,12 @@
 <__|-|__|
 ```
 
-**dino-spec** brings structured, context-aware development to [Claude Code](https://claude.ai/code). It automatically maintains session state, provides 33 MCP tools, and enables intelligent context retrieval with real-time statusline display.
+**dino-spec** brings structured, context-aware development to [Claude Code](https://claude.ai/code). It automatically maintains session state, provides 47 MCP tools, and enables intelligent context retrieval with real-time statusline display.
 
 ## Features
 
-- **MCP Integration** - 33 tools + 19 resources auto-configured during init
+- **MCP Integration** - 47 tools + 29 resources auto-configured during init
+- **Enhanced Observability** - Execution tree, memory access log, context transitions with HTML/JSON export (v9.10.0)
 - **Session State** - Automatic tracking of focus, test/build/lint status, blockers
 - **Persistent Memory** - Decisions, patterns, learnings survive across sessions
 - **Interactive Memory Browser** - TUI for browsing memories with vim-style navigation (v9.0.0)
@@ -106,6 +107,10 @@ Access via `@dino://` in Claude Code:
 | `@dino://handoff` | Agent handoff context |
 | `@dino://memories/summary` | All memories overview |
 | `@dino://retrieval/ranked` | Session-relevant files |
+| `@dino://traces/tree` | Execution tree overview (v9.10.0) |
+| `@dino://traces/memory-access` | Memory access log (v9.10.0) |
+| `@dino://traces/context-graph` | Context transition graph (v9.10.0) |
+| `@dino://traces/overview` | Combined trace overview (v9.10.0) |
 
 ## MCP Tools
 
@@ -134,6 +139,9 @@ Key tools available via Claude Code:
 | `dino_chunk_file` | AST-based semantic chunking |
 | `dino_chunk_analyze` | Chunking analysis |
 | `dino_effort_recommend` | Recommend effort level based on task complexity (v9.9.0) |
+| `dino_trace_export` | Export execution traces to JSON or HTML (v9.10.0) |
+| `dino_memory_access_stats` | View memory operation statistics (v9.10.0) |
+| `dino_context_transitions` | View context transition history (v9.10.0) |
 
 ## Specialized Agents
 

package/dist/core/agents/circuit-breaker.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Circuit Breaker Pattern - v9.10.0
+ *
+ * Prevents repeated failures from wasting context budget.
+ * Implements exponential backoff [1s, 2s, 4s, 8s] and human escalation
+ * after persistent failures.
+ *
+ * State machine:
+ * - CLOSED → OPEN: After failureThreshold consecutive failures
+ * - OPEN → HALF-OPEN: After backoff duration expires
+ * - HALF-OPEN → CLOSED: On success
+ * - HALF-OPEN → OPEN: On failure (with increased backoff)
+ */
+export type CircuitState = 'closed' | 'open' | 'half-open';
+export interface CircuitBreakerConfig {
+    /** Number of failures before opening circuit. Default: 3 */
+    failureThreshold: number;
+    /** Number of successes in half-open to close. Default: 1 */
+    successThreshold: number;
+    /** Base duration for open state in ms. Default: 1000 */
+    openDurationMs: number;
+    /** Backoff multiplier for repeated failures. Default: 2 */
+    backoffMultiplier: number;
+    /** Maximum backoff duration in ms. Default: 8000 */
+    maxBackoffMs: number;
+    /** Failures before requiring human intervention. Default: 5 */
+    humanEscalationThreshold: number;
+    /** Time in ms before resetting failure count. Default: 60000 */
+    resetTimeoutMs: number;
+}
+export interface CircuitStats {
+    state: CircuitState;
+    consecutiveFailures: number;
+    consecutiveSuccesses: number;
+    totalFailures: number;
+    totalSuccesses: number;
+    lastFailureTime: number | null;
+    lastSuccessTime: number | null;
+    currentBackoffMs: number;
+    openUntil: number | null;
+    escalationRequired: boolean;
+    recentErrors: string[];
+}
+export interface CircuitResult<T> {
+    success: boolean;
+    data?: T;
+    error?: Error;
+    circuitState: CircuitState;
+    wasBlocked: boolean;
+    backoffMs?: number;
+}
+export declare const DEFAULT_CONFIG: CircuitBreakerConfig;
+/**
+ * Circuit breaker implementation with state machine
+ */
+export declare class CircuitBreaker {
+    private state;
+    private consecutiveFailures;
+    private consecutiveSuccesses;
+    private totalFailures;
+    private totalSuccesses;
+    private lastFailureTime;
+    private lastSuccessTime;
+    private currentBackoffMs;
+    private openUntil;
+    private recentErrors;
+    private readonly config;
+    readonly operationId: string;
+    constructor(operationId: string, config?: Partial<CircuitBreakerConfig>);
+    /**
+     * Execute an operation with circuit breaker protection
+     */
+    execute<T>(operation: () => Promise<T>): Promise<CircuitResult<T>>;
+    /**
+     * Record a successful operation
+     */
+    recordSuccess(): void;
+    /**
+     * Record a failed operation
+     */
+    recordFailure(error: Error): void;
+    /**
+     * Get current circuit state
+     */
+    getState(): CircuitState;
+    /**
+     * Get detailed circuit statistics
+     */
+    getStats(): CircuitStats;
+    /**
+     * Check if human escalation is required
+     */
+    requiresHumanEscalation(): boolean;
+    /**
+     * Reset circuit breaker to initial state
+     */
+    reset(): void;
+    /**
+     * Get remaining backoff time if circuit is open
+     */
+    getRemainingBackoffMs(): number;
+    /**
+     * Check if the circuit allows operations
+     */
+    isAllowingRequests(): boolean;
+    private transitionToOpen;
+    private transitionToHalfOpen;
+    private transitionToClosed;
+    private increaseBackoff;
+    private checkResetTimeout;
+}
+/**
+ * Format circuit stats for display
+ */
+export declare function formatCircuitStats(stats: CircuitStats): string;
+//# sourceMappingURL=circuit-breaker.d.ts.map

package/dist/core/agents/circuit-breaker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.d.ts","sourceRoot":"","sources":["../../../src/core/agents/circuit-breaker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AAE3D,MAAM,WAAW,oBAAoB;IACnC,4DAA4D;IAC5D,gBAAgB,EAAE,MAAM,CAAC;IACzB,4DAA4D;IAC5D,gBAAgB,EAAE,MAAM,CAAC;IACzB,wDAAwD;IACxD,cAAc,EAAE,MAAM,CAAC;IACvB,2DAA2D;IAC3D,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oDAAoD;IACpD,YAAY,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,wBAAwB,EAAE,MAAM,CAAC;IACjC,gEAAgE;IAChE,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,YAAY,CAAC;IACpB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,YAAY,EAAE,YAAY,CAAC;IAC3B,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAMD,eAAO,MAAM,cAAc,EAAE,oBAQ5B,CAAC;AAQF;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,mBAAmB,CAAK;IAChC,OAAO,CAAC,oBAAoB,CAAK;IACjC,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAC9C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;gBAEjB,WAAW,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,CAAC,oBAAoB,CAAM;IAM3E;;OAEG;IACG,OAAO,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAyCxE;;OAEG;IACH,aAAa,IAAI,IAAI;IAarB;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAuBjC;;OAEG;IACH,QAAQ,IAAI,YAAY;IAKxB;;OAEG;IACH,QAAQ,IAAI,YAAY;IAiBxB;;OAEG;IACH,uBAAuB,IAAI,OAAO;IAIlC;;OAEG;IACH,KAAK,IAAI,IAAI;IAab;;OAEG;IACH,qBAAqB,IAAI,MAAM;IAO/B;;OAEG;IACH,kBAAkB,IAAI,OAAO;IAe7B,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,oBAAoB;IAM5B,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,iBAAiB;CAW1B;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAsB9D"}

package/dist/core/agents/circuit-breaker.js

@@ -0,0 +1,260 @@
+/**
+ * Circuit Breaker Pattern - v9.10.0
+ *
+ * Prevents repeated failures from wasting context budget.
+ * Implements exponential backoff [1s, 2s, 4s, 8s] and human escalation
+ * after persistent failures.
+ *
+ * State machine:
+ * - CLOSED → OPEN: After failureThreshold consecutive failures
+ * - OPEN → HALF-OPEN: After backoff duration expires
+ * - HALF-OPEN → CLOSED: On success
+ * - HALF-OPEN → OPEN: On failure (with increased backoff)
+ */
+// =============================================================================
+// Constants
+// =============================================================================
+export const DEFAULT_CONFIG = {
+    failureThreshold: 3,
+    successThreshold: 1,
+    openDurationMs: 1000,
+    backoffMultiplier: 2,
+    maxBackoffMs: 8000,
+    humanEscalationThreshold: 5,
+    resetTimeoutMs: 60000,
+};
+const MAX_RECENT_ERRORS = 5;
+// =============================================================================
+// Circuit Breaker Class
+// =============================================================================
+/**
+ * Circuit breaker implementation with state machine
+ */
+export class CircuitBreaker {
+    state = 'closed';
+    consecutiveFailures = 0;
+    consecutiveSuccesses = 0;
+    totalFailures = 0;
+    totalSuccesses = 0;
+    lastFailureTime = null;
+    lastSuccessTime = null;
+    currentBackoffMs;
+    openUntil = null;
+    recentErrors = [];
+    config;
+    operationId;
+    constructor(operationId, config = {}) {
+        this.operationId = operationId;
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.currentBackoffMs = this.config.openDurationMs;
+    }
+    /**
+     * Execute an operation with circuit breaker protection
+     */
+    async execute(operation) {
+        // Check if we need to reset due to timeout
+        this.checkResetTimeout();
+        // Check if circuit is open
+        if (this.state === 'open') {
+            const now = Date.now();
+            if (this.openUntil && now < this.openUntil) {
+                return {
+                    success: false,
+                    circuitState: this.state,
+                    wasBlocked: true,
+                    backoffMs: this.openUntil - now,
+                };
+            }
+            // Transition to half-open
+            this.transitionToHalfOpen();
+        }
+        try {
+            const data = await operation();
+            this.recordSuccess();
+            return {
+                success: true,
+                data,
+                circuitState: this.state,
+                wasBlocked: false,
+            };
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            this.recordFailure(err);
+            return {
+                success: false,
+                error: err,
+                circuitState: this.state,
+                wasBlocked: false,
+                backoffMs: this.state === 'open' ? this.currentBackoffMs : undefined,
+            };
+        }
+    }
+    /**
+     * Record a successful operation
+     */
+    recordSuccess() {
+        this.consecutiveSuccesses++;
+        this.consecutiveFailures = 0;
+        this.totalSuccesses++;
+        this.lastSuccessTime = Date.now();
+        if (this.state === 'half-open') {
+            if (this.consecutiveSuccesses >= this.config.successThreshold) {
+                this.transitionToClosed();
+            }
+        }
+    }
+    /**
+     * Record a failed operation
+     */
+    recordFailure(error) {
+        this.consecutiveFailures++;
+        this.consecutiveSuccesses = 0;
+        this.totalFailures++;
+        this.lastFailureTime = Date.now();
+        // Store recent error
+        this.recentErrors.push(error.message);
+        if (this.recentErrors.length > MAX_RECENT_ERRORS) {
+            this.recentErrors.shift();
+        }
+        if (this.state === 'closed') {
+            if (this.consecutiveFailures >= this.config.failureThreshold) {
+                this.transitionToOpen();
+            }
+        }
+        else if (this.state === 'half-open') {
+            // Failed in half-open, go back to open with increased backoff
+            this.increaseBackoff();
+            this.transitionToOpen();
+        }
+    }
+    /**
+     * Get current circuit state
+     */
+    getState() {
+        this.checkResetTimeout();
+        return this.state;
+    }
+    /**
+     * Get detailed circuit statistics
+     */
+    getStats() {
+        this.checkResetTimeout();
+        return {
+            state: this.state,
+            consecutiveFailures: this.consecutiveFailures,
+            consecutiveSuccesses: this.consecutiveSuccesses,
+            totalFailures: this.totalFailures,
+            totalSuccesses: this.totalSuccesses,
+            lastFailureTime: this.lastFailureTime,
+            lastSuccessTime: this.lastSuccessTime,
+            currentBackoffMs: this.currentBackoffMs,
+            openUntil: this.openUntil,
+            escalationRequired: this.requiresHumanEscalation(),
+            recentErrors: [...this.recentErrors],
+        };
+    }
+    /**
+     * Check if human escalation is required
+     */
+    requiresHumanEscalation() {
+        return this.totalFailures >= this.config.humanEscalationThreshold;
+    }
+    /**
+     * Reset circuit breaker to initial state
+     */
+    reset() {
+        this.state = 'closed';
+        this.consecutiveFailures = 0;
+        this.consecutiveSuccesses = 0;
+        this.totalFailures = 0;
+        this.totalSuccesses = 0;
+        this.lastFailureTime = null;
+        this.lastSuccessTime = null;
+        this.currentBackoffMs = this.config.openDurationMs;
+        this.openUntil = null;
+        this.recentErrors = [];
+    }
+    /**
+     * Get remaining backoff time if circuit is open
+     */
+    getRemainingBackoffMs() {
+        if (this.state !== 'open' || !this.openUntil) {
+            return 0;
+        }
+        return Math.max(0, this.openUntil - Date.now());
+    }
+    /**
+     * Check if the circuit allows operations
+     */
+    isAllowingRequests() {
+        this.checkResetTimeout();
+        if (this.state === 'closed')
+            return true;
+        if (this.state === 'half-open')
+            return true;
+        if (this.state === 'open' && this.openUntil && Date.now() >= this.openUntil) {
+            this.transitionToHalfOpen();
+            return true;
+        }
+        return false;
+    }
+    // ===========================================================================
+    // Private Methods
+    // ===========================================================================
+    transitionToOpen() {
+        this.state = 'open';
+        this.openUntil = Date.now() + this.currentBackoffMs;
+        this.consecutiveSuccesses = 0;
+    }
+    transitionToHalfOpen() {
+        this.state = 'half-open';
+        this.openUntil = null;
+        this.consecutiveSuccesses = 0;
+    }
+    transitionToClosed() {
+        this.state = 'closed';
+        this.openUntil = null;
+        this.consecutiveFailures = 0;
+        // Reset backoff on successful recovery
+        this.currentBackoffMs = this.config.openDurationMs;
+    }
+    increaseBackoff() {
+        this.currentBackoffMs = Math.min(this.currentBackoffMs * this.config.backoffMultiplier, this.config.maxBackoffMs);
+    }
+    checkResetTimeout() {
+        // Reset failure count if enough time has passed since last failure
+        if (this.lastFailureTime &&
+            Date.now() - this.lastFailureTime > this.config.resetTimeoutMs &&
+            this.state === 'closed') {
+            this.consecutiveFailures = 0;
+            this.recentErrors = [];
+        }
+    }
+}
+// =============================================================================
+// Utility Functions
+// =============================================================================
+/**
+ * Format circuit stats for display
+ */
+export function formatCircuitStats(stats) {
+    const lines = [
+        `State: ${stats.state}`,
+        `Consecutive failures: ${stats.consecutiveFailures}`,
+        `Total: ${stats.totalSuccesses} successes, ${stats.totalFailures} failures`,
+    ];
+    if (stats.state === 'open' && stats.openUntil) {
+        const remaining = Math.max(0, stats.openUntil - Date.now());
+        lines.push(`Retry in: ${Math.ceil(remaining / 1000)}s`);
+    }
+    if (stats.escalationRequired) {
+        lines.push(`⚠️ Human escalation required`);
+    }
+    if (stats.recentErrors.length > 0) {
+        lines.push(`Recent errors:`);
+        stats.recentErrors.forEach((e, i) => lines.push(`  ${i + 1}. ${e}`));
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=circuit-breaker.js.map

package/dist/core/agents/circuit-breaker.js.map

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

package/dist/core/agents/circuit-registry.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Circuit Breaker Registry - v9.10.0
+ *
+ * Central registry managing multiple circuit breakers by operation ID.
+ * Provides singleton access pattern matching budgetManager.
+ *
+ * Categories with different defaults:
+ * - mcp-tool: MCP tool calls (threshold: 3, escalation: 5)
+ * - agent: Sub-agent spawning (threshold: 2, escalation: 4)
+ * - memory: Memory/retrieval operations (threshold: 4, escalation: 6)
+ * - external: External API calls (threshold: 3, escalation: 5)
+ */
+import { CircuitBreaker, CircuitStats, CircuitBreakerConfig } from './circuit-breaker.js';
+export type BreakerCategory = 'mcp-tool' | 'agent' | 'memory' | 'external';
+export interface CategoryConfig extends Partial<CircuitBreakerConfig> {
+    /** Description of this category */
+    description: string;
+}
+export interface RegistryStats {
+    totalBreakers: number;
+    openBreakers: number;
+    halfOpenBreakers: number;
+    closedBreakers: number;
+    escalationsRequired: number;
+    byCategory: Record<BreakerCategory, number>;
+}
+export interface OpenCircuitInfo {
+    operationId: string;
+    category: BreakerCategory;
+    stats: CircuitStats;
+    remainingMs: number;
+}
+export declare const CATEGORY_CONFIGS: Record<BreakerCategory, CategoryConfig>;
+/**
+ * Registry managing multiple circuit breakers
+ */
+export declare class CircuitBreakerRegistry {
+    private breakers;
+    private categories;
+    /**
+     * Get or create a circuit breaker for an operation
+     */
+    getBreaker(operationId: string, category: BreakerCategory): CircuitBreaker;
+    /**
+     * Get all open circuits with their info
+     */
+    getOpenCircuits(): OpenCircuitInfo[];
+    /**
+     * Get circuits requiring human escalation
+     */
+    getEscalationRequired(): OpenCircuitInfo[];
+    /**
+     * Get registry statistics
+     */
+    getStats(): RegistryStats;
+    /**
+     * Reset a specific circuit breaker
+     */
+    resetBreaker(operationId: string): boolean;
+    /**
+     * Reset all circuit breakers
+     */
+    resetAll(): void;
+    /**
+     * Remove a circuit breaker from registry
+     */
+    removeBreaker(operationId: string): boolean;
+    /**
+     * Clear all circuit breakers from registry
+     */
+    clear(): void;
+    /**
+     * Get a breaker's stats if it exists
+     */
+    getBreakerStats(operationId: string): CircuitStats | null;
+    /**
+     * List all operation IDs
+     */
+    listOperations(): string[];
+    /**
+     * List operations by category
+     */
+    listByCategory(category: BreakerCategory): string[];
+}
+/**
+ * Global circuit breaker registry singleton
+ */
+export declare const circuitRegistry: CircuitBreakerRegistry;
+/**
+ * Wrap an async function with circuit breaker protection
+ */
+export declare function withCircuitBreaker<T>(fn: () => Promise<T>, operationId: string, category: BreakerCategory): Promise<T>;
+/**
+ * Format registry stats for display
+ */
+export declare function formatRegistryStats(stats: RegistryStats): string;
+/**
+ * Format open circuits for display
+ */
+export declare function formatOpenCircuits(circuits: OpenCircuitInfo[]): string;
+//# sourceMappingURL=circuit-registry.d.ts.map

package/dist/core/agents/circuit-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-registry.d.ts","sourceRoot":"","sources":["../../../src/core/agents/circuit-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,cAAc,EACd,YAAY,EACZ,oBAAoB,EAGrB,MAAM,sBAAsB,CAAC;AAM9B,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE3E,MAAM,WAAW,cAAe,SAAQ,OAAO,CAAC,oBAAoB,CAAC;IACnE,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,eAAe,CAAC;IAC1B,KAAK,EAAE,YAAY,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAMD,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,eAAe,EAAE,cAAc,CAyBpE,CAAC;AAMF;;GAEG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAA0C;IAC1D,OAAO,CAAC,UAAU,CAA2C;IAE7D;;OAEG;IACH,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,cAAc;IAoB1E;;OAEG;IACH,eAAe,IAAI,eAAe,EAAE;IAmBpC;;OAEG;IACH,qBAAqB,IAAI,eAAe,EAAE;IAkB1C;;OAEG;IACH,QAAQ,IAAI,aAAa;IAyCzB;;OAEG;IACH,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAS1C;;OAEG;IACH,QAAQ,IAAI,IAAI;IAMhB;;OAEG;IACH,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAK3C;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAKzD;;OAEG;IACH,cAAc,IAAI,MAAM,EAAE;IAI1B;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,EAAE;CASpD;AAMD;;GAEG;AACH,eAAO,MAAM,eAAe,wBAA+B,CAAC;AAM5D;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EACxC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,eAAe,GACxB,OAAO,CAAC,CAAC,CAAC,CAwBZ;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAyBhE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,eAAe,EAAE,GAAG,MAAM,CA+BtE"}