@agent-relay/resiliency 0.1.0

package/dist/metrics.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Agent Resiliency Metrics
+ *
+ * Collects and exposes metrics about agent health, crashes, and restarts.
+ * - Prometheus-compatible format
+ * - In-memory aggregation
+ * - Real-time stats
+ */
+export interface AgentMetrics {
+    name: string;
+    spawns: number;
+    crashes: number;
+    restarts: number;
+    successfulRestarts: number;
+    failedRestarts: number;
+    currentStatus: 'healthy' | 'unhealthy' | 'dead' | 'unknown';
+    uptimeMs: number;
+    lastCrashAt?: Date;
+    lastCrashReason?: string;
+    avgUptimeMs: number;
+    memoryUsageBytes?: number;
+    cpuUsagePercent?: number;
+}
+export interface SystemMetrics {
+    totalAgents: number;
+    healthyAgents: number;
+    unhealthyAgents: number;
+    deadAgents: number;
+    totalCrashes: number;
+    totalRestarts: number;
+    uptimeSeconds: number;
+    memoryUsageMb: number;
+}
+export interface MetricPoint {
+    name: string;
+    value: number;
+    labels: Record<string, string>;
+    timestamp: number;
+}
+declare class MetricsCollector {
+    private agents;
+    private startTime;
+    private history;
+    private maxHistorySize;
+    /**
+     * Record an agent spawn
+     */
+    recordSpawn(name: string): void;
+    /**
+     * Record an agent crash
+     */
+    recordCrash(name: string, reason: string): void;
+    /**
+     * Record a restart attempt
+     */
+    recordRestartAttempt(name: string): void;
+    /**
+     * Record a successful restart
+     */
+    recordRestartSuccess(name: string): void;
+    /**
+     * Record a failed restart
+     */
+    recordRestartFailure(name: string, reason: string): void;
+    /**
+     * Mark agent as dead (exceeded max restarts)
+     */
+    recordDead(name: string): void;
+    /**
+     * Update resource usage
+     */
+    updateResourceUsage(name: string, memoryBytes: number, cpuPercent: number): void;
+    /**
+     * Get metrics for a specific agent
+     */
+    getAgentMetrics(name: string): AgentMetrics | undefined;
+    /**
+     * Get metrics for all agents
+     */
+    getAllAgentMetrics(): AgentMetrics[];
+    /**
+     * Get system-wide metrics
+     */
+    getSystemMetrics(): SystemMetrics;
+    /**
+     * Export metrics in Prometheus format
+     */
+    toPrometheus(): string;
+    /**
+     * Export metrics as JSON
+     */
+    toJSON(): {
+        system: SystemMetrics;
+        agents: AgentMetrics[];
+    };
+    /**
+     * Get recent metric history
+     */
+    getHistory(name?: string, since?: Date): MetricPoint[];
+    /**
+     * Reset all metrics
+     */
+    reset(): void;
+    /**
+     * Get or create agent metrics
+     */
+    private getOrCreate;
+    /**
+     * Record a metric point
+     */
+    private record;
+}
+export declare const metrics: MetricsCollector;
+export {};
+//# sourceMappingURL=metrics.d.ts.map

package/dist/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,SAAS,GAAG,WAAW,GAAG,MAAM,GAAG,SAAS,CAAC;IAC5D,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,cAAM,gBAAgB;IACpB,OAAO,CAAC,MAAM,CAAmC;IACjD,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,cAAc,CAAS;IAE/B;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAO/B;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAiB/C;;OAEG;IACH,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAOxC;;OAEG;IACH,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAOxC;;OAEG;IACH,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAMxD;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAM9B;;OAEG;IACH,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAQhF;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIvD;;OAEG;IACH,kBAAkB,IAAI,YAAY,EAAE;IAIpC;;OAEG;IACH,gBAAgB,IAAI,aAAa;IAejC;;OAEG;IACH,YAAY,IAAI,MAAM;IAmEtB;;OAEG;IACH,MAAM,IAAI;QAAE,MAAM,EAAE,aAAa,CAAC;QAAC,MAAM,EAAE,YAAY,EAAE,CAAA;KAAE;IAO3D;;OAEG;IACH,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,IAAI,GAAG,WAAW,EAAE;IAetD;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,OAAO,CAAC,WAAW;IAmBnB;;OAEG;IACH,OAAO,CAAC,MAAM;CAef;AAGD,eAAO,MAAM,OAAO,kBAAyB,CAAC"}

package/dist/metrics.js

@@ -0,0 +1,239 @@
+/**
+ * Agent Resiliency Metrics
+ *
+ * Collects and exposes metrics about agent health, crashes, and restarts.
+ * - Prometheus-compatible format
+ * - In-memory aggregation
+ * - Real-time stats
+ */
+class MetricsCollector {
+    agents = new Map();
+    startTime = Date.now();
+    history = [];
+    maxHistorySize = 10000;
+    /**
+     * Record an agent spawn
+     */
+    recordSpawn(name) {
+        const metrics = this.getOrCreate(name);
+        metrics.spawns++;
+        metrics.currentStatus = 'healthy';
+        this.record('agent_spawns_total', 1, { agent: name });
+    }
+    /**
+     * Record an agent crash
+     */
+    recordCrash(name, reason) {
+        const metrics = this.getOrCreate(name);
+        metrics.crashes++;
+        metrics.lastCrashAt = new Date();
+        metrics.lastCrashReason = reason;
+        metrics.currentStatus = 'unhealthy';
+        // Update average uptime
+        if (metrics.spawns > 0) {
+            const currentUptime = Date.now() - (this.startTime + metrics.uptimeMs);
+            metrics.avgUptimeMs =
+                (metrics.avgUptimeMs * (metrics.spawns - 1) + currentUptime) / metrics.spawns;
+        }
+        this.record('agent_crashes_total', 1, { agent: name, reason });
+    }
+    /**
+     * Record a restart attempt
+     */
+    recordRestartAttempt(name) {
+        const metrics = this.getOrCreate(name);
+        metrics.restarts++;
+        metrics.currentStatus = 'unhealthy';
+        this.record('agent_restart_attempts_total', 1, { agent: name });
+    }
+    /**
+     * Record a successful restart
+     */
+    recordRestartSuccess(name) {
+        const metrics = this.getOrCreate(name);
+        metrics.successfulRestarts++;
+        metrics.currentStatus = 'healthy';
+        this.record('agent_restart_success_total', 1, { agent: name });
+    }
+    /**
+     * Record a failed restart
+     */
+    recordRestartFailure(name, reason) {
+        const metrics = this.getOrCreate(name);
+        metrics.failedRestarts++;
+        this.record('agent_restart_failures_total', 1, { agent: name, reason });
+    }
+    /**
+     * Mark agent as dead (exceeded max restarts)
+     */
+    recordDead(name) {
+        const metrics = this.getOrCreate(name);
+        metrics.currentStatus = 'dead';
+        this.record('agent_dead_total', 1, { agent: name });
+    }
+    /**
+     * Update resource usage
+     */
+    updateResourceUsage(name, memoryBytes, cpuPercent) {
+        const metrics = this.getOrCreate(name);
+        metrics.memoryUsageBytes = memoryBytes;
+        metrics.cpuUsagePercent = cpuPercent;
+        this.record('agent_memory_bytes', memoryBytes, { agent: name });
+        this.record('agent_cpu_percent', cpuPercent, { agent: name });
+    }
+    /**
+     * Get metrics for a specific agent
+     */
+    getAgentMetrics(name) {
+        return this.agents.get(name);
+    }
+    /**
+     * Get metrics for all agents
+     */
+    getAllAgentMetrics() {
+        return Array.from(this.agents.values());
+    }
+    /**
+     * Get system-wide metrics
+     */
+    getSystemMetrics() {
+        const allMetrics = this.getAllAgentMetrics();
+        return {
+            totalAgents: allMetrics.length,
+            healthyAgents: allMetrics.filter((m) => m.currentStatus === 'healthy').length,
+            unhealthyAgents: allMetrics.filter((m) => m.currentStatus === 'unhealthy').length,
+            deadAgents: allMetrics.filter((m) => m.currentStatus === 'dead').length,
+            totalCrashes: allMetrics.reduce((sum, m) => sum + m.crashes, 0),
+            totalRestarts: allMetrics.reduce((sum, m) => sum + m.restarts, 0),
+            uptimeSeconds: Math.floor((Date.now() - this.startTime) / 1000),
+            memoryUsageMb: Math.round(process.memoryUsage().heapUsed / 1024 / 1024),
+        };
+    }
+    /**
+     * Export metrics in Prometheus format
+     */
+    toPrometheus() {
+        const lines = [];
+        const system = this.getSystemMetrics();
+        // System metrics
+        lines.push('# HELP agent_relay_uptime_seconds Total uptime in seconds');
+        lines.push('# TYPE agent_relay_uptime_seconds gauge');
+        lines.push(`agent_relay_uptime_seconds ${system.uptimeSeconds}`);
+        lines.push('# HELP agent_relay_agents_total Total number of agents');
+        lines.push('# TYPE agent_relay_agents_total gauge');
+        lines.push(`agent_relay_agents_total ${system.totalAgents}`);
+        lines.push('# HELP agent_relay_agents_healthy Number of healthy agents');
+        lines.push('# TYPE agent_relay_agents_healthy gauge');
+        lines.push(`agent_relay_agents_healthy ${system.healthyAgents}`);
+        lines.push('# HELP agent_relay_agents_unhealthy Number of unhealthy agents');
+        lines.push('# TYPE agent_relay_agents_unhealthy gauge');
+        lines.push(`agent_relay_agents_unhealthy ${system.unhealthyAgents}`);
+        lines.push('# HELP agent_relay_agents_dead Number of dead agents');
+        lines.push('# TYPE agent_relay_agents_dead gauge');
+        lines.push(`agent_relay_agents_dead ${system.deadAgents}`);
+        lines.push('# HELP agent_relay_crashes_total Total number of crashes');
+        lines.push('# TYPE agent_relay_crashes_total counter');
+        lines.push(`agent_relay_crashes_total ${system.totalCrashes}`);
+        lines.push('# HELP agent_relay_restarts_total Total number of restart attempts');
+        lines.push('# TYPE agent_relay_restarts_total counter');
+        lines.push(`agent_relay_restarts_total ${system.totalRestarts}`);
+        lines.push('# HELP agent_relay_memory_bytes Memory usage in bytes');
+        lines.push('# TYPE agent_relay_memory_bytes gauge');
+        lines.push(`agent_relay_memory_bytes ${system.memoryUsageMb * 1024 * 1024}`);
+        // Per-agent metrics
+        lines.push('# HELP agent_crashes_total Crashes per agent');
+        lines.push('# TYPE agent_crashes_total counter');
+        for (const m of this.getAllAgentMetrics()) {
+            lines.push(`agent_crashes_total{agent="${m.name}"} ${m.crashes}`);
+        }
+        lines.push('# HELP agent_restarts_total Restart attempts per agent');
+        lines.push('# TYPE agent_restarts_total counter');
+        for (const m of this.getAllAgentMetrics()) {
+            lines.push(`agent_restarts_total{agent="${m.name}"} ${m.restarts}`);
+        }
+        lines.push('# HELP agent_status Current agent status (0=unknown, 1=healthy, 2=unhealthy, 3=dead)');
+        lines.push('# TYPE agent_status gauge');
+        for (const m of this.getAllAgentMetrics()) {
+            const statusValue = m.currentStatus === 'healthy'
+                ? 1
+                : m.currentStatus === 'unhealthy'
+                    ? 2
+                    : m.currentStatus === 'dead'
+                        ? 3
+                        : 0;
+            lines.push(`agent_status{agent="${m.name}"} ${statusValue}`);
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Export metrics as JSON
+     */
+    toJSON() {
+        return {
+            system: this.getSystemMetrics(),
+            agents: this.getAllAgentMetrics(),
+        };
+    }
+    /**
+     * Get recent metric history
+     */
+    getHistory(name, since) {
+        let points = this.history;
+        if (since) {
+            const sinceTs = since.getTime();
+            points = points.filter((p) => p.timestamp >= sinceTs);
+        }
+        if (name) {
+            points = points.filter((p) => p.labels.agent === name);
+        }
+        return points;
+    }
+    /**
+     * Reset all metrics
+     */
+    reset() {
+        this.agents.clear();
+        this.history = [];
+        this.startTime = Date.now();
+    }
+    /**
+     * Get or create agent metrics
+     */
+    getOrCreate(name) {
+        let metrics = this.agents.get(name);
+        if (!metrics) {
+            metrics = {
+                name,
+                spawns: 0,
+                crashes: 0,
+                restarts: 0,
+                successfulRestarts: 0,
+                failedRestarts: 0,
+                currentStatus: 'unknown',
+                uptimeMs: 0,
+                avgUptimeMs: 0,
+            };
+            this.agents.set(name, metrics);
+        }
+        return metrics;
+    }
+    /**
+     * Record a metric point
+     */
+    record(name, value, labels) {
+        const point = {
+            name,
+            value,
+            labels,
+            timestamp: Date.now(),
+        };
+        this.history.push(point);
+        // Trim history if too large
+        if (this.history.length > this.maxHistorySize) {
+            this.history = this.history.slice(-this.maxHistorySize / 2);
+        }
+    }
+}
+// Singleton instance
+export const metrics = new MetricsCollector();
+//# sourceMappingURL=metrics.js.map

package/dist/metrics.js.map

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

package/dist/provider-context.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Provider-Specific Context Injection
+ *
+ * Handles context persistence differently based on the AI provider:
+ * - Claude: Uses hooks (PreToolUse, PostToolUse, Stop) to inject/save context
+ * - Codex: Uses config settings for periodic context refresh
+ * - Gemini: Uses system instruction updates
+ */
+import { ContextPersistence, Handoff } from './context-persistence.js';
+export type ProviderType = 'claude' | 'codex' | 'gemini' | 'cursor' | 'generic';
+export interface ProviderContextConfig {
+    provider: ProviderType;
+    workingDir: string;
+    agentName: string;
+    task?: string;
+}
+export interface ClaudeHooksConfig {
+    hooksDir: string;
+    onPreToolUse?: boolean;
+    onStop?: boolean;
+    contextFile?: string;
+}
+export interface CodexContextConfig {
+    configPath: string;
+    contextRefreshInterval?: number;
+    systemPromptPath?: string;
+}
+/**
+ * Base class for provider-specific context handling
+ */
+declare abstract class ProviderContextHandler {
+    protected persistence: ContextPersistence;
+    protected config: ProviderContextConfig;
+    constructor(config: ProviderContextConfig);
+    abstract setup(): Promise<void>;
+    abstract injectContext(handoff: Handoff): Promise<void>;
+    abstract saveContext(): Promise<void>;
+    abstract cleanup(): Promise<void>;
+    protected getState(): import("./context-persistence.js").AgentState | undefined;
+}
+/**
+ * Claude Context Handler using Hooks
+ *
+ * Creates hooks that:
+ * - Pre-tool: Inject resumption context before critical operations
+ * - Stop: Save state to ledger on session end
+ */
+export declare class ClaudeContextHandler extends ProviderContextHandler {
+    private hooksConfig;
+    constructor(config: ProviderContextConfig, hooksConfig?: Partial<ClaudeHooksConfig>);
+    setup(): Promise<void>;
+    injectContext(handoff: Handoff): Promise<void>;
+    saveContext(): Promise<void>;
+    cleanup(): Promise<void>;
+    private createStopHookScript;
+}
+/**
+ * Codex Context Handler using Config
+ *
+ * Uses Codex's configuration for:
+ * - Periodic context refresh via system prompt updates
+ * - History file for context continuity
+ */
+export declare class CodexContextHandler extends ProviderContextHandler {
+    private codexConfig;
+    private refreshInterval?;
+    constructor(config: ProviderContextConfig, codexConfig?: Partial<CodexContextConfig>);
+    setup(): Promise<void>;
+    injectContext(_handoff: Handoff): Promise<void>;
+    saveContext(): Promise<void>;
+    /**
+     * Start periodic context refresh
+     */
+    startPeriodicRefresh(): void;
+    stopPeriodicRefresh(): void;
+    cleanup(): Promise<void>;
+}
+/**
+ * Gemini Context Handler
+ *
+ * Uses system instruction file for context injection
+ */
+export declare class GeminiContextHandler extends ProviderContextHandler {
+    private systemInstructionPath;
+    constructor(config: ProviderContextConfig);
+    setup(): Promise<void>;
+    injectContext(_handoff: Handoff): Promise<void>;
+    saveContext(): Promise<void>;
+    cleanup(): Promise<void>;
+}
+/**
+ * Factory function to create the appropriate context handler
+ */
+export declare function createContextHandler(config: ProviderContextConfig, providerOptions?: Record<string, unknown>): ProviderContextHandler;
+/**
+ * Detect provider from CLI command
+ */
+export declare function detectProvider(cli: string): ProviderType;
+export {};
+//# sourceMappingURL=provider-context.d.ts.map

package/dist/provider-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-context.d.ts","sourceRoot":"","sources":["../src/provider-context.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,EAAE,kBAAkB,EAAyB,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAI9F,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEhF,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,YAAY,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,uBAAe,sBAAsB;IACnC,SAAS,CAAC,WAAW,EAAE,kBAAkB,CAAC;IAC1C,SAAS,CAAC,MAAM,EAAE,qBAAqB,CAAC;gBAE5B,MAAM,EAAE,qBAAqB;IAOzC,QAAQ,CAAC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAC/B,QAAQ,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IACvD,QAAQ,CAAC,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IACrC,QAAQ,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAEjC,SAAS,CAAC,QAAQ;CAGnB;AAED;;;;;;GAMG;AACH,qBAAa,oBAAqB,SAAQ,sBAAsB;IAC9D,OAAO,CAAC,WAAW,CAAoB;gBAE3B,MAAM,EAAE,qBAAqB,EAAE,WAAW,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC;IAW7E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAwDtB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAuC9C,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAY9B,OAAO,CAAC,oBAAoB;CAoB7B;AAED;;;;;;GAMG;AACH,qBAAa,mBAAoB,SAAQ,sBAAsB;IAC7D,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,eAAe,CAAC,CAAiC;gBAE7C,MAAM,EAAE,qBAAqB,EAAE,WAAW,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC;IAU9E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAqCtB,aAAa,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAiC/C,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAKlC;;OAEG;IACH,oBAAoB,IAAI,IAAI;IAa5B,mBAAmB,IAAI,IAAI;IAOrB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAY/B;AAED;;;;GAIG;AACH,qBAAa,oBAAqB,SAAQ,sBAAsB;IAC9D,OAAO,CAAC,qBAAqB,CAAS;gBAE1B,MAAM,EAAE,qBAAqB;IASnC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAWtB,aAAa,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IA0B/C,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAU/B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,qBAAqB,EAC7B,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACxC,sBAAsB,CAcxB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAMxD"}