overmind-mcp 2.8.12 → 2.8.13

package/dist/bridge/AgentRegistry.d.ts

@@ -0,0 +1,123 @@
+/**
+ * ╔══════════════════════════════════════════════════════════════════════╗
+ * ║   OVERMIND BRIDGE — AgentRegistry (In-Memory State Tracker)          ║
+ * ║                                                                      ║
+ * ║   Tracke l'état live de chaque agent : busy / idle / offline.        ║
+ * ║   Sérialise les appels concurrents vers un même agent via mutex.    ║
+ * ║                                                                      ║
+ * ║   ARCHITECTURE                                                       ║
+ * ║   ─────────────                                                      ║
+ * ║   OverBridgeServer → AgentRegistry → (mutex per agent)               ║
+ * ║                       → OverBridgeService.runAgent()                ║
+ * ╚══════════════════════════════════════════════════════════════════════╝
+ */
+import type { RunnerType } from './types.js';
+import { type BridgeLogger } from './utils.js';
+export type AgentLiveStatus = 'online' | 'offline' | 'busy' | 'idle';
+export interface AgentLiveState {
+    name: string;
+    runner: RunnerType;
+    status: AgentLiveStatus;
+    /** PID du process si connu (via agent_control status) */
+    pid?: number;
+    /** SessionId de l'appel en cours (si busy) */
+    currentSessionId?: string;
+    /** Timestamp dernière activité (runAgent / heartbeat) */
+    lastActivityAt: number;
+    /** Compteur de runs total depuis le boot du bridge */
+    totalRuns: number;
+    /** Compteur de runs échoués */
+    totalErrors: number;
+    /** Compteur A2A (combien de fois cet agent a été appelé par un autre agent) */
+    a2aReceived: number;
+    /** Compteur A2A (combien de fois cet agent a appelé un autre agent) */
+    a2aSent: number;
+}
+export interface ListAgentsFilter {
+    /** Filtre par status (ex: tous les 'busy') */
+    status?: AgentLiveStatus;
+    /** Filtre par runner (ex: 'claude', 'hermes') */
+    runner?: RunnerType;
+}
+export declare class AgentRegistry {
+    private readonly states;
+    private readonly mutexes;
+    private readonly log;
+    constructor(logger?: BridgeLogger);
+    /**
+     * Récupère (ou crée) le mutex associé à un agent.
+     * Garantit qu'un seul appel runAgent tourne à la fois par agent.
+     */
+    private getMutex;
+    /**
+     * Exécute une fonction sous le mutex de l'agent.
+     * Bloque si un autre run est en cours sur le même agent.
+     */
+    withLock<T>(agentName: string, fn: () => Promise<T>): Promise<T>;
+    /**
+     * Vérifie si un run est actuellement en cours sur cet agent.
+     */
+    isBusy(agentName: string): boolean;
+    /**
+     * Initialise ou met à jour l'état d'un agent.
+     * Appelé au premier runAgent ou explicitement via register().
+     */
+    register(agentName: string, runner: RunnerType): AgentLiveState;
+    /**
+     * Marque un agent comme busy (run en cours).
+     */
+    markBusy(agentName: string, sessionId?: string, pid?: number): void;
+    /**
+     * Marque un agent comme idle (run terminé, agent dispo).
+     */
+    markIdle(agentName: string, success: boolean): void;
+    /**
+     * Marque un agent comme offline (kill, crash, ou jamais vu).
+     */
+    markOffline(agentName: string): void;
+    /**
+     * Marque un agent comme online (vu récemment, pas en cours).
+     */
+    markOnline(agentName: string): void;
+    /**
+     * Incrémente le compteur A2A received (cet agent a été appelé par un autre).
+     */
+    incrementA2aReceived(agentName: string): void;
+    /**
+     * Incrémente le compteur A2A sent (cet agent a appelé un autre).
+     */
+    incrementA2aSent(agentName: string): void;
+    /**
+     * Récupère l'état d'un agent. Retourne undefined si jamais vu.
+     */
+    get(agentName: string): AgentLiveState | undefined;
+    /**
+     * Liste tous les agents connus, optionnellement filtrés.
+     */
+    list(filter?: ListAgentsFilter): AgentLiveState[];
+    /**
+     * Liste les agents actuellement busy (utile pour /status global).
+     */
+    listBusy(): AgentLiveState[];
+    /**
+     * Liste les agents online et idle (disponibles pour run).
+     */
+    listAvailable(): AgentLiveState[];
+    /**
+     * Statistiques globales du registry.
+     */
+    stats(): {
+        total: number;
+        online: number;
+        busy: number;
+        offline: number;
+        totalRuns: number;
+        totalErrors: number;
+    };
+    /**
+     * Purge les agents offline depuis plus de `maxAgeMs`.
+     * Évite que la map grossisse indéfiniment.
+     */
+    prune(maxAgeMs?: number): number;
+}
+//# sourceMappingURL=AgentRegistry.d.ts.map

package/dist/bridge/AgentRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentRegistry.d.ts","sourceRoot":"","sources":["../../src/bridge/AgentRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAInE,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;AAErE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,eAAe,CAAC;IACxB,yDAAyD;IACzD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,yDAAyD;IACzD,cAAc,EAAE,MAAM,CAAC;IACvB,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,+EAA+E;IAC/E,WAAW,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,8CAA8C;IAC9C,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,iDAAiD;IACjD,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAID,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqC;IAC5D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IACpD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;gBAEvB,MAAM,CAAC,EAAE,YAAY;IAMjC;;;OAGG;IACH,OAAO,CAAC,QAAQ;IAShB;;;OAGG;IACG,QAAQ,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAItE;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAMlC;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,cAAc;IAqB/D;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IASnE;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAUnD;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAQpC;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAOnC;;OAEG;IACH,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAK7C;;OAEG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAOzC;;OAEG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAKlD;;OAEG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,cAAc,EAAE;IAWjD;;OAEG;IACH,QAAQ,IAAI,cAAc,EAAE;IAI5B;;OAEG;IACH,aAAa,IAAI,cAAc,EAAE;IAIjC;;OAEG;IACH,KAAK,IAAI;QACP,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;KACrB;IAYD;;;OAGG;IACH,KAAK,CAAC,QAAQ,SAAsB,GAAG,MAAM;CAe9C"}

package/dist/bridge/AgentRegistry.js

@@ -0,0 +1,207 @@
+/**
+ * ╔══════════════════════════════════════════════════════════════════════╗
+ * ║   OVERMIND BRIDGE — AgentRegistry (In-Memory State Tracker)          ║
+ * ║                                                                      ║
+ * ║   Tracke l'état live de chaque agent : busy / idle / offline.        ║
+ * ║   Sérialise les appels concurrents vers un même agent via mutex.    ║
+ * ║                                                                      ║
+ * ║   ARCHITECTURE                                                       ║
+ * ║   ─────────────                                                      ║
+ * ║   OverBridgeServer → AgentRegistry → (mutex per agent)               ║
+ * ║                       → OverBridgeService.runAgent()                ║
+ * ╚══════════════════════════════════════════════════════════════════════╝
+ */
+import { Mutex } from 'async-mutex';
+import { createBridgeLogger } from './utils.js';
+// ─── AgentRegistry ────────────────────────────────────────────────────────
+export class AgentRegistry {
+    states = new Map();
+    mutexes = new Map();
+    log;
+    constructor(logger) {
+        this.log = logger ?? createBridgeLogger('agent-registry');
+    }
+    // ─── Mutex Helpers ──────────────────────────────────────────────────────
+    /**
+     * Récupère (ou crée) le mutex associé à un agent.
+     * Garantit qu'un seul appel runAgent tourne à la fois par agent.
+     */
+    getMutex(agentName) {
+        let mutex = this.mutexes.get(agentName);
+        if (!mutex) {
+            mutex = new Mutex();
+            this.mutexes.set(agentName, mutex);
+        }
+        return mutex;
+    }
+    /**
+     * Exécute une fonction sous le mutex de l'agent.
+     * Bloque si un autre run est en cours sur le même agent.
+     */
+    async withLock(agentName, fn) {
+        return this.getMutex(agentName).runExclusive(fn);
+    }
+    /**
+     * Vérifie si un run est actuellement en cours sur cet agent.
+     */
+    isBusy(agentName) {
+        return this.getMutex(agentName).isLocked();
+    }
+    // ─── State Management ───────────────────────────────────────────────────
+    /**
+     * Initialise ou met à jour l'état d'un agent.
+     * Appelé au premier runAgent ou explicitement via register().
+     */
+    register(agentName, runner) {
+        const existing = this.states.get(agentName);
+        if (existing) {
+            existing.runner = runner; // Update runner if changed
+            return existing;
+        }
+        const state = {
+            name: agentName,
+            runner,
+            status: 'online',
+            lastActivityAt: Date.now(),
+            totalRuns: 0,
+            totalErrors: 0,
+            a2aReceived: 0,
+            a2aSent: 0,
+        };
+        this.states.set(agentName, state);
+        this.log.info(`📝 Agent registered: ${agentName} (${runner})`);
+        return state;
+    }
+    /**
+     * Marque un agent comme busy (run en cours).
+     */
+    markBusy(agentName, sessionId, pid) {
+        const state = this.states.get(agentName);
+        if (!state)
+            return;
+        state.status = 'busy';
+        state.currentSessionId = sessionId;
+        state.pid = pid;
+        state.lastActivityAt = Date.now();
+    }
+    /**
+     * Marque un agent comme idle (run terminé, agent dispo).
+     */
+    markIdle(agentName, success) {
+        const state = this.states.get(agentName);
+        if (!state)
+            return;
+        state.status = 'online';
+        state.currentSessionId = undefined;
+        state.lastActivityAt = Date.now();
+        state.totalRuns++;
+        if (!success)
+            state.totalErrors++;
+    }
+    /**
+     * Marque un agent comme offline (kill, crash, ou jamais vu).
+     */
+    markOffline(agentName) {
+        const state = this.states.get(agentName);
+        if (!state)
+            return;
+        state.status = 'offline';
+        state.currentSessionId = undefined;
+        state.pid = undefined;
+    }
+    /**
+     * Marque un agent comme online (vu récemment, pas en cours).
+     */
+    markOnline(agentName) {
+        const state = this.states.get(agentName);
+        if (!state)
+            return;
+        state.status = 'online';
+        state.lastActivityAt = Date.now();
+    }
+    /**
+     * Incrémente le compteur A2A received (cet agent a été appelé par un autre).
+     */
+    incrementA2aReceived(agentName) {
+        const state = this.states.get(agentName);
+        if (state)
+            state.a2aReceived++;
+    }
+    /**
+     * Incrémente le compteur A2A sent (cet agent a appelé un autre).
+     */
+    incrementA2aSent(agentName) {
+        const state = this.states.get(agentName);
+        if (state)
+            state.a2aSent++;
+    }
+    // ─── Queries ────────────────────────────────────────────────────────────
+    /**
+     * Récupère l'état d'un agent. Retourne undefined si jamais vu.
+     */
+    get(agentName) {
+        const state = this.states.get(agentName);
+        return state ? { ...state } : undefined;
+    }
+    /**
+     * Liste tous les agents connus, optionnellement filtrés.
+     */
+    list(filter) {
+        const all = Array.from(this.states.values()).map((s) => ({ ...s }));
+        if (!filter)
+            return all;
+        return all.filter((s) => {
+            if (filter.status && s.status !== filter.status)
+                return false;
+            if (filter.runner && s.runner !== filter.runner)
+                return false;
+            return true;
+        });
+    }
+    /**
+     * Liste les agents actuellement busy (utile pour /status global).
+     */
+    listBusy() {
+        return this.list({ status: 'busy' });
+    }
+    /**
+     * Liste les agents online et idle (disponibles pour run).
+     */
+    listAvailable() {
+        return this.list().filter((s) => s.status === 'online' || s.status === 'idle');
+    }
+    /**
+     * Statistiques globales du registry.
+     */
+    stats() {
+        const all = Array.from(this.states.values());
+        return {
+            total: all.length,
+            online: all.filter((s) => s.status === 'online').length,
+            busy: all.filter((s) => s.status === 'busy').length,
+            offline: all.filter((s) => s.status === 'offline').length,
+            totalRuns: all.reduce((acc, s) => acc + s.totalRuns, 0),
+            totalErrors: all.reduce((acc, s) => acc + s.totalErrors, 0),
+        };
+    }
+    /**
+     * Purge les agents offline depuis plus de `maxAgeMs`.
+     * Évite que la map grossisse indéfiniment.
+     */
+    prune(maxAgeMs = 24 * 60 * 60 * 1000) {
+        const cutoff = Date.now() - maxAgeMs;
+        let pruned = 0;
+        for (const [name, state] of this.states) {
+            if (state.status === 'offline' && state.lastActivityAt < cutoff) {
+                this.states.delete(name);
+                this.mutexes.delete(name);
+                pruned++;
+            }
+        }
+        if (pruned > 0) {
+            this.log.info(`🧹 Pruned ${pruned} stale offline agents`);
+        }
+        return pruned;
+    }
+}
+//# sourceMappingURL=AgentRegistry.js.map

package/dist/bridge/AgentRegistry.js.map

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

package/dist/bridge/MessageLog.d.ts

@@ -0,0 +1,142 @@
+/**
+ * ╔══════════════════════════════════════════════════════════════════════╗
+ * ║   OVERMIND BRIDGE — MessageLog (Postgres Persistence)                ║
+ * ║                                                                      ║
+ * ║   Persiste tous les messages agent↔agent et client→agent dans       ║
+ * ║   Postgres pour audit, replay après crash, et statistiques.          ║
+ * ║                                                                      ║
+ * ║   TABLE                                                              ║
+ * ║   ──────                                                             ║
+ * ║   bridge_messages                                                    ║
+ * ║     id              UUID PK                                          ║
+ * ║     from_agent      TEXT NULL   (NULL = client externe)              ║
+ * ║     to_agent        TEXT NOT NULL                                    ║
+ * ║     runner          TEXT NOT NULL                                    ║
+ * ║     prompt          TEXT NOT NULL                                    ║
+ * ║     response        TEXT NULL                                        ║
+ * ║     status          TEXT NOT NULL (pending|running|done|failed)     ║
+ * ║     session_id      TEXT NULL                                        ║
+ * ║     metadata        JSONB NULL   (path, model, mode, discord ctx)    ║
+ * ║     error           TEXT NULL                                        ║
+ * ║     created_at      TIMESTAMPTZ                                      ║
+ * ║     started_at      TIMESTAMPTZ NULL                                 ║
+ * ║     completed_at    TIMESTAMPTZ NULL                                 ║
+ * ║     duration_ms     INTEGER NULL                                     ║
+ * ╚══════════════════════════════════════════════════════════════════════╝
+ */
+import { type BridgeLogger } from './utils.js';
+import type { RunnerType } from './types.js';
+export type MessageStatus = 'pending' | 'running' | 'done' | 'failed' | 'timeout';
+export interface PersistedMessage {
+    id: string;
+    fromAgent: string | null;
+    toAgent: string;
+    runner: RunnerType;
+    prompt: string;
+    response: string | null;
+    status: MessageStatus;
+    sessionId: string | null;
+    metadata: Record<string, unknown> | null;
+    error: string | null;
+    createdAt: Date;
+    startedAt: Date | null;
+    completedAt: Date | null;
+    durationMs: number | null;
+}
+export interface CreateMessageInput {
+    fromAgent?: string | null;
+    toAgent: string;
+    runner: RunnerType;
+    prompt: string;
+    sessionId?: string;
+    metadata?: Record<string, unknown> | null;
+}
+export interface ListMessagesFilter {
+    toAgent?: string;
+    /** null = filtre les messages sans fromAgent (i.e. venant d'un client externe) */
+    fromAgent?: string | null;
+    status?: MessageStatus;
+    /** Limite de résultats (default: 50) */
+    limit?: number;
+    /** Offset pour pagination (default: 0) */
+    offset?: number;
+    /** Depuis N heures (ex: 24 = dernières 24h) */
+    sinceHours?: number;
+}
+export interface MessageLogConfig {
+    host: string;
+    port: number;
+    user: string;
+    password: string;
+    database: string;
+    /** SSL (default: false) */
+    ssl?: boolean;
+    /** Pool min/max (default: 2/10) */
+    poolMin?: number;
+    poolMax?: number;
+}
+export declare class MessageLog {
+    private readonly config;
+    private pool;
+    private readonly log;
+    private initialized;
+    constructor(config: MessageLogConfig, logger?: BridgeLogger);
+    /**
+     * Initialise le pool Postgres et crée le schéma si nécessaire.
+     * Idempotent : peut être appelé plusieurs fois sans danger.
+     */
+    init(): Promise<void>;
+    /**
+     * Ferme proprement le pool.
+     */
+    close(): Promise<void>;
+    /**
+     * Crée un message en status 'pending' et retourne son ID.
+     */
+    create(input: CreateMessageInput): Promise<string>;
+    /**
+     * Marque un message comme 'running' (appel MCP en cours).
+     */
+    markRunning(id: string, sessionId?: string): Promise<void>;
+    /**
+     * Marque un message comme 'done' avec sa réponse.
+     */
+    markDone(id: string, response: string, sessionId?: string): Promise<void>;
+    /**
+     * Marque un message comme 'failed' avec erreur.
+     */
+    markFailed(id: string, error: string): Promise<void>;
+    /**
+     * Marque un message comme 'timeout'.
+     */
+    markTimeout(id: string): Promise<void>;
+    /**
+     * Récupère un message par ID.
+     */
+    getById(id: string): Promise<PersistedMessage | null>;
+    /**
+     * Liste les messages avec filtres et pagination.
+     */
+    list(filter?: ListMessagesFilter): Promise<PersistedMessage[]>;
+    /**
+     * Trouve les messages 'pending' ou 'running' depuis plus de X minutes (stuck).
+     * Utile pour le replay automatique au redémarrage.
+     */
+    findStuck(stuckAfterMinutes?: number): Promise<PersistedMessage[]>;
+    /**
+     * Statistiques globales du log.
+     */
+    stats(sinceHours?: number): Promise<{
+        total: number;
+        byStatus: Record<MessageStatus, number>;
+        byRunner: Record<string, number>;
+        avgDurationMs: number | null;
+    }>;
+    private assertReady;
+}
+/**
+ * Charge la config Postgres depuis process.env (POSTGRES_*).
+   * Utilise les variables déjà dans .env.
+   */
+export declare function loadMessageLogConfigFromEnv(): MessageLogConfig;
+//# sourceMappingURL=MessageLog.d.ts.map

package/dist/bridge/MessageLog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageLog.d.ts","sourceRoot":"","sources":["../../src/bridge/MessageLog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAGH,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAI7C,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;AAElF,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACzC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;IACvB,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC3C;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAiCD,qBAAa,UAAU;IAMnB,OAAO,CAAC,QAAQ,CAAC,MAAM;IALzB,OAAO,CAAC,IAAI,CAAsB;IAClC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,WAAW,CAAS;gBAGT,MAAM,EAAE,gBAAgB,EACzC,MAAM,CAAC,EAAE,YAAY;IAOvB;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAgC3B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAW5B;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IAmBxD;;OAEG;IACG,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUhE;;OAEG;IACG,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB/E;;OAEG;IACG,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU1D;;OAEG;IACG,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU5C;;OAEG;IACG,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAS3D;;OAEG;IACG,IAAI,CAAC,MAAM,GAAE,kBAAuB,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAyCxE;;;OAGG;IACG,SAAS,CAAC,iBAAiB,SAAI,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAYnE;;OAEG;IACG,KAAK,CAAC,UAAU,SAAK,GAAG,OAAO,CAAC;QACpC,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QACxC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;KAC9B,CAAC;IAoDF,OAAO,CAAC,WAAW;CAKpB;AA0CD;;;KAGK;AACL,wBAAgB,2BAA2B,IAAI,gBAAgB,CAe9D"}