overmind-mcp 2.8.13 → 2.8.15

package/dist/bridge/ArgParser.d.ts

@@ -0,0 +1,45 @@
+/**
+ * ╔══════════════════════════════════════════════════════════════════════╗
+ * ║   OVERMIND BRIDGE — ArgParser (Zero-Dep CLI Parser)                  ║
+ * ║                                                                      ║
+ * ║   Parser d'arguments minimaliste, cohérent avec le style du projet.  ║
+ * ║   Supporte :                                                          ║
+ * ║     - Flags courts (-v) et longs (--verbose)                         ║
+ * ║     - Valeurs via = ou espace (--port 3100, --port=3100)             ║
+ * ║     - Valeurs répétées (--include a --include b)                     ║
+ * ║     - Booléens negations (--no-auth)                                 ║
+ * ║     - Stdin auto-détection                                            ║
+ * ╚══════════════════════════════════════════════════════════════════════╝
+ */
+export type ArgValue = string | boolean | number | string[];
+export interface ParsedArgs {
+    /** Premier arg = subcommand (ex: 'server', 'call', 'scenario') */
+    command: string | undefined;
+    /** Tous les args après le subcommand, indexés par flag (sans le --) */
+    flags: Record<string, ArgValue>;
+    /** Positionals (args sans flag) */
+    positionals: string[];
+    /** Args bruts pour debug */
+    raw: string[];
+}
+/**
+ * Parse process.argv.slice(2). Le premier non-flag devient `command`.
+ */
+export declare function parseArgs(argv?: string[]): ParsedArgs;
+/**
+ * Récupère un flag avec valeur par défaut et coercion de type.
+ */
+export declare function getFlag<T extends ArgValue>(args: ParsedArgs, name: string, defaultValue?: T): T | undefined;
+/**
+ * Récupère un flag, throw si manquant.
+ */
+export declare function requireFlag<T extends ArgValue>(args: ParsedArgs, name: string): T;
+/**
+ * Vérifie si stdin a des données piped (TTY = false).
+ */
+export declare function hasStdinData(): boolean;
+/**
+ * Lit stdin en entier (utf-8).
+ */
+export declare function readStdin(): Promise<string>;
+//# sourceMappingURL=ArgParser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ArgParser.d.ts","sourceRoot":"","sources":["../../src/bridge/ArgParser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC;AAE5D,MAAM,WAAW,UAAU;IACzB,kEAAkE;IAClE,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAChC,mCAAmC;IACnC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,4BAA4B;IAC5B,GAAG,EAAE,MAAM,EAAE,CAAC;CACf;AAID;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,UAAU,CAmE5E;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,QAAQ,EACxC,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,MAAM,EACZ,YAAY,CAAC,EAAE,CAAC,GACf,CAAC,GAAG,SAAS,CAIf;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,CAMjF;AAgBD;;GAEG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAED;;GAEG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAQjD"}

package/dist/bridge/ArgParser.js

@@ -0,0 +1,134 @@
+/**
+ * ╔══════════════════════════════════════════════════════════════════════╗
+ * ║   OVERMIND BRIDGE — ArgParser (Zero-Dep CLI Parser)                  ║
+ * ║                                                                      ║
+ * ║   Parser d'arguments minimaliste, cohérent avec le style du projet.  ║
+ * ║   Supporte :                                                          ║
+ * ║     - Flags courts (-v) et longs (--verbose)                         ║
+ * ║     - Valeurs via = ou espace (--port 3100, --port=3100)             ║
+ * ║     - Valeurs répétées (--include a --include b)                     ║
+ * ║     - Booléens negations (--no-auth)                                 ║
+ * ║     - Stdin auto-détection                                            ║
+ * ╚══════════════════════════════════════════════════════════════════════╝
+ */
+// ─── Public API ────────────────────────────────────────────────────────────
+/**
+ * Parse process.argv.slice(2). Le premier non-flag devient `command`.
+ */
+export function parseArgs(argv = process.argv.slice(2)) {
+    const flags = {};
+    const positionals = [];
+    let command;
+    let commandConsumed = false;
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        // --flag=value
+        if (arg.startsWith('--') && arg.includes('=')) {
+            const eqIdx = arg.indexOf('=');
+            const key = arg.slice(2, eqIdx);
+            const value = arg.slice(eqIdx + 1);
+            flags[key] = coerceValue(value, true);
+            if (!commandConsumed) {
+                command = key; // au cas où le subcommand est en --foo=bar (rare)
+                commandConsumed = true;
+            }
+            continue;
+        }
+        // --flag value | --flag
+        if (arg.startsWith('--')) {
+            const key = arg.slice(2);
+            const next = argv[i + 1];
+            // Booléen si prochain arg est un autre flag ou rien
+            if (next === undefined || next.startsWith('--')) {
+                flags[key] = true;
+            }
+            else {
+                flags[key] = coerceValue(next, false);
+                i++; // consomme la valeur
+            }
+            continue;
+        }
+        // -f value | -f | -abc (flags courts combinés)
+        if (arg.startsWith('-') && arg.length > 1) {
+            // Combinés : -abc → a, b, c tous booléens
+            if (/^-[a-z]+$/i.test(arg)) {
+                for (const ch of arg.slice(1)) {
+                    flags[ch] = true;
+                }
+                continue;
+            }
+            // -v value
+            const key = arg.slice(1);
+            const next = argv[i + 1];
+            if (next === undefined || next.startsWith('--')) {
+                flags[key] = true;
+            }
+            else {
+                flags[key] = coerceValue(next, false);
+                i++;
+            }
+            continue;
+        }
+        // Positionnel
+        if (!commandConsumed) {
+            command = arg;
+            commandConsumed = true;
+        }
+        else {
+            positionals.push(arg);
+        }
+    }
+    return { command, flags, positionals, raw: argv };
+}
+/**
+ * Récupère un flag avec valeur par défaut et coercion de type.
+ */
+export function getFlag(args, name, defaultValue) {
+    const value = args.flags[name];
+    if (value === undefined)
+        return defaultValue;
+    return value;
+}
+/**
+ * Récupère un flag, throw si manquant.
+ */
+export function requireFlag(args, name) {
+    const value = args.flags[name];
+    if (value === undefined) {
+        throw new Error(`Missing required flag: --${name}`);
+    }
+    return value;
+}
+// ─── Helpers ───────────────────────────────────────────────────────────────
+function coerceValue(raw, fromEquals) {
+    // Si --flag=true / false
+    if (raw === 'true')
+        return true;
+    if (raw === 'false')
+        return false;
+    // Si nombre
+    if (/^-?\d+(\.\d+)?$/.test(raw))
+        return Number(raw);
+    // Sinon string brut
+    return raw;
+}
+// ─── Stdin detection ───────────────────────────────────────────────────────
+/**
+ * Vérifie si stdin a des données piped (TTY = false).
+ */
+export function hasStdinData() {
+    return !process.stdin.isTTY;
+}
+/**
+ * Lit stdin en entier (utf-8).
+ */
+export async function readStdin() {
+    return new Promise((resolve, reject) => {
+        let data = '';
+        process.stdin.setEncoding('utf-8');
+        process.stdin.on('data', (chunk) => (data += chunk));
+        process.stdin.on('end', () => resolve(data));
+        process.stdin.on('error', reject);
+    });
+}
+//# sourceMappingURL=ArgParser.js.map

package/dist/bridge/ArgParser.js.map

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

package/dist/bridge/BridgeHttpClient.d.ts

@@ -0,0 +1,61 @@
+/**
+ * ╔══════════════════════════════════════════════════════════════════════╗
+ * ║   OVERMIND BRIDGE — BridgeHttpClient (JSON-RPC 2.0 HTTP Caller)     ║
+ * ║                                                                      ║
+ * ║   Client HTTP minimaliste pour parler à un OverBridgeServer.         ║
+ * ║   Utilisé par le CLI pour les commandes 'call', 'scenario', etc.     ║
+ * ║   Supporte :                                                          ║
+ * ║     - Single + batch JSON-RPC 2.0                                    ║
+ * ║     - Auth Bearer token                                              ║
+ * ║     - Timeout configurable                                            ║
+ * ║     - Mode "auto" : démarre un bridge local si pas de serveur       ║
+ * ╚══════════════════════════════════════════════════════════════════════╝
+ */
+export interface JsonRpcCallRequest {
+    jsonrpc: '2.0';
+    id: number | string;
+    method: string;
+    params?: Record<string, unknown>;
+}
+export interface JsonRpcCallResponse {
+    jsonrpc: '2.0';
+    id: number | string | null;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+export interface BridgeHttpClientConfig {
+    /** URL complète du serveur (ex: http://127.0.0.1:3100) */
+    baseUrl: string;
+    /** Bearer token (si configuré côté serveur) */
+    authToken?: string;
+    /** Timeout par défaut en ms (default: 60_000) */
+    timeoutMs?: number;
+}
+export declare class BridgeHttpClient {
+    private readonly config;
+    private rpcId;
+    constructor(config: BridgeHttpClientConfig);
+    get baseUrl(): string;
+    /**
+     * Appelle une méthode JSON-RPC et retourne le résultat (ou throw).
+     */
+    call<T = unknown>(method: string, params?: Record<string, unknown>, timeoutMs?: number): Promise<T>;
+    /**
+     * Batch JSON-RPC (plusieurs calls en un round-trip).
+     */
+    callBatch<T = unknown>(calls: Array<{
+        method: string;
+        params?: Record<string, unknown>;
+    }>): Promise<T[]>;
+    /**
+     * GET /health (pas JSON-RPC, endpoint séparé).
+     */
+    health(): Promise<unknown>;
+    private _post;
+    private _get;
+}
+//# sourceMappingURL=BridgeHttpClient.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BridgeHttpClient.d.ts","sourceRoot":"","sources":["../../src/bridge/BridgeHttpClient.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAC3D;AAED,MAAM,WAAW,sBAAsB;IACrC,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CACqB;IAC5C,OAAO,CAAC,KAAK,CAAK;gBAEN,MAAM,EAAE,sBAAsB;IAQ1C,IAAI,OAAO,IAAI,MAAM,CAEpB;IAID;;OAEG;IACG,IAAI,CAAC,CAAC,GAAG,OAAO,EACpB,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,CAAC,CAAC;IAmBb;;OAEG;IACG,SAAS,CAAC,CAAC,GAAG,OAAO,EACzB,KAAK,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,GACjE,OAAO,CAAC,CAAC,EAAE,CAAC;IAqBf;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;YAOlB,KAAK;YAiDL,IAAI;CAoCnB"}

package/dist/bridge/BridgeHttpClient.js

@@ -0,0 +1,164 @@
+/**
+ * ╔══════════════════════════════════════════════════════════════════════╗
+ * ║   OVERMIND BRIDGE — BridgeHttpClient (JSON-RPC 2.0 HTTP Caller)     ║
+ * ║                                                                      ║
+ * ║   Client HTTP minimaliste pour parler à un OverBridgeServer.         ║
+ * ║   Utilisé par le CLI pour les commandes 'call', 'scenario', etc.     ║
+ * ║   Supporte :                                                          ║
+ * ║     - Single + batch JSON-RPC 2.0                                    ║
+ * ║     - Auth Bearer token                                              ║
+ * ║     - Timeout configurable                                            ║
+ * ║     - Mode "auto" : démarre un bridge local si pas de serveur       ║
+ * ╚══════════════════════════════════════════════════════════════════════╝
+ */
+import http from 'node:http';
+import { URL } from 'node:url';
+// ─── BridgeHttpClient ──────────────────────────────────────────────────────
+export class BridgeHttpClient {
+    config;
+    rpcId = 1;
+    constructor(config) {
+        this.config = {
+            baseUrl: config.baseUrl.replace(/\/+$/, ''), // strip trailing slashes
+            authToken: config.authToken,
+            timeoutMs: config.timeoutMs ?? 60_000,
+        };
+    }
+    get baseUrl() {
+        return this.config.baseUrl;
+    }
+    // ─── JSON-RPC Calls ──────────────────────────────────────────────────────
+    /**
+     * Appelle une méthode JSON-RPC et retourne le résultat (ou throw).
+     */
+    async call(method, params, timeoutMs) {
+        const req = {
+            jsonrpc: '2.0',
+            id: this.rpcId++,
+            method,
+            params,
+        };
+        const res = await this._post('/rpc', req, timeoutMs ?? this.config.timeoutMs);
+        if (Array.isArray(res)) {
+            throw new Error('Unexpected batch response to single call');
+        }
+        if (res.error) {
+            const err = new Error(`JSON-RPC error ${res.error.code}: ${res.error.message}`);
+            Object.assign(err, { code: res.error.code, data: res.error.data });
+            throw err;
+        }
+        return res.result;
+    }
+    /**
+     * Batch JSON-RPC (plusieurs calls en un round-trip).
+     */
+    async callBatch(calls) {
+        const reqs = calls.map((c) => ({
+            jsonrpc: '2.0',
+            id: this.rpcId++,
+            method: c.method,
+            params: c.params,
+        }));
+        const responses = await this._post('/rpc', reqs, this.config.timeoutMs);
+        if (!Array.isArray(responses)) {
+            throw new Error('Batch call did not return an array');
+        }
+        return responses.map((r) => {
+            if (r.error) {
+                const err = new Error(`JSON-RPC error ${r.error.code}: ${r.error.message}`);
+                Object.assign(err, { code: r.error.code, data: r.error.data });
+                throw err;
+            }
+            return r.result;
+        });
+    }
+    /**
+     * GET /health (pas JSON-RPC, endpoint séparé).
+     */
+    async health() {
+        const res = await this._get('/health', 5_000);
+        return JSON.parse(res);
+    }
+    // ─── HTTP Helpers ────────────────────────────────────────────────────────
+    async _post(path, body, timeoutMs) {
+        const url = new URL(this.config.baseUrl + path);
+        const data = JSON.stringify(body);
+        return new Promise((resolve, reject) => {
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), timeoutMs);
+            const req = http.request({
+                hostname: url.hostname,
+                port: url.port || (url.protocol === 'https:' ? 443 : 80),
+                path: url.pathname + url.search,
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Accept': 'application/json',
+                    'Content-Length': Buffer.byteLength(data),
+                    ...(this.config.authToken ? { Authorization: `Bearer ${this.config.authToken}` } : {}),
+                },
+                signal: controller.signal,
+            }, (res) => {
+                clearTimeout(timer);
+                const chunks = [];
+                res.on('data', (chunk) => chunks.push(chunk));
+                res.on('end', () => {
+                    const text = Buffer.concat(chunks).toString('utf-8');
+                    if (res.statusCode && res.statusCode >= 200 && res.statusCode < 300) {
+                        try {
+                            resolve(JSON.parse(text));
+                        }
+                        catch (err) {
+                            reject(new Error(`Invalid JSON response: ${text.slice(0, 200)}`));
+                        }
+                    }
+                    else {
+                        reject(new Error(`HTTP ${res.statusCode}: ${text.slice(0, 200)}`));
+                    }
+                });
+                res.on('error', reject);
+            });
+            req.on('error', (err) => {
+                clearTimeout(timer);
+                reject(err);
+            });
+            req.write(data);
+            req.end();
+        });
+    }
+    async _get(path, timeoutMs) {
+        const url = new URL(this.config.baseUrl + path);
+        return new Promise((resolve, reject) => {
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), timeoutMs);
+            const req = http.request({
+                hostname: url.hostname,
+                port: url.port || 80,
+                path: url.pathname + url.search,
+                method: 'GET',
+                headers: { Accept: 'application/json' },
+                signal: controller.signal,
+            }, (res) => {
+                clearTimeout(timer);
+                const chunks = [];
+                res.on('data', (chunk) => chunks.push(chunk));
+                res.on('end', () => {
+                    const text = Buffer.concat(chunks).toString('utf-8');
+                    if (res.statusCode && res.statusCode >= 200 && res.statusCode < 300) {
+                        resolve(text);
+                    }
+                    else {
+                        reject(new Error(`HTTP ${res.statusCode}: ${text.slice(0, 200)}`));
+                    }
+                });
+                res.on('error', reject);
+            });
+            req.on('error', (err) => {
+                clearTimeout(timer);
+                reject(err);
+            });
+            req.end();
+        });
+    }
+}
+//# sourceMappingURL=BridgeHttpClient.js.map

package/dist/bridge/BridgeHttpClient.js.map

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

package/dist/bridge/DirectiveParser.d.ts

@@ -0,0 +1,82 @@
+/**
+ * ╔══════════════════════════════════════════════════════════════════════╗
+ * ║   OVERMIND BRIDGE — DirectiveParser (Agent-Side Protocol)            ║
+ * ║                                                                      ║
+ * ║   Permet aux agents d'injecter des directives structurées dans      ║
+ * ║   leurs réponses textuelles. Le bridge les extrait et les exécute.  ║
+ * ║                                                                      ║
+ * ║   PATTERN                                                            ║
+ * ║   ───────                                                            ║
+ * ║   Inspiré du `CONTEXT_UPDATE: step=X employe_id=Y` de bt-sms.        ║
+ * ║                                                                      ║
+ * ║   L'agent écrit dans sa réponse :                                   ║
+ * ║                                                                      ║
+ * ║     "Voici mon analyse.                                             ║
+ * ║      SESSION_ID: hermes-sess-abc123                                  ║
+ * ║      CONTEXT_UPDATE: step=awaiting_description employe_id=42         ║
+ * ║      BRIDGE_NEXT: agent=scout prompt=\"Analyse BTC\"                  ║
+ * ║      BRIDGE_END"                                                      ║
+ * ║                                                                      ║
+ * ║   Le bridge :                                                        ║
+ * ║     1. Extrait SESSION_ID, l'assigne au store                       ║
+ * ║     2. Patche le context (state machine)                            ║
+ * ║     3. Lance automatiquement un nouveau call vers scout              ║
+ * ║     4. Supprime les directives du texte retourné au client          ║
+ * ║                                                                      ║
+ * ║   DIRECTIVES SUPPORTÉES                                              ║
+ * ║   ──────────────────────                                             ║
+ * ║   - SESSION_ID: <id>             → assigne le sessionId             ║
+ * ║   - CONTEXT_UPDATE: k=v k=v      → patche le context                ║
+ * ║   - BRIDGE_NEXT: method=X ...    → déclenche un appel suivant       ║
+ * ║   - BRIDGE_END                   → arrête la chaîne de next calls   ║
+ * ║   - BRIDGE_HINT: <text>          → tag/metadata (no action)         ║
+ * ╚══════════════════════════════════════════════════════════════════════╝
+ */
+import { type BridgeLogger } from './utils.js';
+import type { JsonRpcRequest } from './OverBridgeServer.js';
+export type DirectiveAction = {
+    kind: 'session';
+    sessionId: string;
+} | {
+    kind: 'context';
+    patch: Record<string, string>;
+} | {
+    kind: 'next';
+    call: JsonRpcRequest;
+} | {
+    kind: 'end';
+} | {
+    kind: 'hint';
+    text: string;
+};
+export interface ParsedDirectives {
+    /** Texte original sans les directives (propre, pour le client) */
+    cleanText: string;
+    /** Directives extraites, dans l'ordre */
+    actions: DirectiveAction[];
+    /** Erreurs de parsing (lignes mal formées, ignorées mais loguées) */
+    errors: string[];
+}
+export interface DirectiveParserOptions {
+    /** Logger */
+    logger?: BridgeLogger;
+}
+export declare class DirectiveParser {
+    private readonly log;
+    constructor(opts?: DirectiveParserOptions);
+    /**
+     * Parse un texte de réponse d'agent et extrait les directives.
+     * Lignes de directive : `DIRECTIVE_NAME: value`.
+     */
+    parse(responseText: string): ParsedDirectives;
+    /**
+     * Parse une directive individuelle. Retourne null si nom inconnu.
+     */
+    private parseDirective;
+}
+/**
+ * Parse un format "key=value key2='value with spaces' key3="value with quotes"".
+ * Supporte quotes simples, doubles, et backslash escape.
+ */
+export declare function parseKeyValueArgs(input: string): Record<string, string>;
+//# sourceMappingURL=DirectiveParser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DirectiveParser.d.ts","sourceRoot":"","sources":["../../src/bridge/DirectiveParser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAI5D,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAClD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,cAAc,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,GACf;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnC,MAAM,WAAW,gBAAgB;IAC/B,kEAAkE;IAClE,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,qEAAqE;IACrE,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,aAAa;IACb,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAID,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;gBAEvB,IAAI,GAAE,sBAA2B;IAI7C;;;OAGG;IACH,KAAK,CAAC,YAAY,EAAE,MAAM,GAAG,gBAAgB;IAkC7C;;OAEG;IACH,OAAO,CAAC,cAAc;CAwCvB;AAID;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAYvE"}