helixmind 0.5.4

package/dist/cli/jarvis/telegram-bot.js

@@ -0,0 +1,251 @@
+/**
+ * Jarvis Telegram Bot — Bidirectional messaging via Telegram Bot API.
+ * Uses native fetch() (Node 18+), no external dependencies.
+ * Long-polling mode — no webhook server needed.
+ */
+export class JarvisTelegramBot {
+    token;
+    allowedChatId;
+    polling = false;
+    offset = 0;
+    onMessage;
+    onCallback;
+    pollTimer;
+    abortController;
+    botUsername; // cached from getMe
+    constructor(token, chatId) {
+        this.token = token;
+        this.allowedChatId = chatId;
+    }
+    /**
+     * Start long-polling for incoming messages.
+     * Fetches bot username for @mention detection and requests all relevant update types.
+     */
+    start(onMessage, onCallback) {
+        if (this.polling)
+            return;
+        this.polling = true;
+        this.onMessage = onMessage;
+        this.onCallback = onCallback;
+        // Cache bot username for @mention detection
+        this.apiCall('getMe').then((res) => {
+            if (res?.ok && res.result?.username) {
+                this.botUsername = res.result.username.toLowerCase();
+            }
+        }).catch(() => { });
+        this.poll();
+    }
+    /**
+     * Stop polling.
+     */
+    stop() {
+        this.polling = false;
+        this.abortController?.abort();
+        if (this.pollTimer) {
+            clearTimeout(this.pollTimer);
+            this.pollTimer = undefined;
+        }
+    }
+    /**
+     * Send a text message (with optional inline keyboard).
+     */
+    async send(text, opts) {
+        const body = {
+            chat_id: opts?.chatId || this.allowedChatId,
+            text,
+            parse_mode: opts?.parseMode ?? 'Markdown',
+        };
+        if (opts?.buttons && opts.buttons.length > 0) {
+            body.reply_markup = {
+                inline_keyboard: opts.buttons.map(row => row.map(btn => ({ text: btn.text, callback_data: btn.callback_data }))),
+            };
+        }
+        await this.apiCall('sendMessage', body);
+    }
+    /**
+     * Answer a callback query (dismiss button loading state).
+     */
+    async answerCallback(queryId, text) {
+        await this.apiCall('answerCallbackQuery', {
+            callback_query_id: queryId,
+            text: text || '',
+        });
+    }
+    /**
+     * Check if bot token is valid.
+     */
+    async verify() {
+        try {
+            const res = await this.apiCall('getMe');
+            if (res.ok) {
+                if (res.result?.username) {
+                    this.botUsername = res.result.username.toLowerCase();
+                }
+                return { ok: true, botName: res.result?.username || res.result?.first_name };
+            }
+            return { ok: false };
+        }
+        catch {
+            return { ok: false };
+        }
+    }
+    get isRunning() {
+        return this.polling;
+    }
+    // ─── Internal ─────────────────────────────────────────────────────────
+    async poll() {
+        if (!this.polling)
+            return;
+        try {
+            this.abortController = new AbortController();
+            // Request all relevant update types: messages, channel posts, callback queries, chat member changes
+            const allowedUpdates = encodeURIComponent(JSON.stringify([
+                'message', 'callback_query', 'channel_post', 'my_chat_member',
+            ]));
+            const res = await fetch(`https://api.telegram.org/bot${this.token}/getUpdates?offset=${this.offset}&timeout=25&allowed_updates=${allowedUpdates}`, { signal: this.abortController.signal });
+            if (!res.ok) {
+                // Rate limited or auth error — back off
+                this.pollTimer = setTimeout(() => this.poll(), 10_000);
+                return;
+            }
+            const data = (await res.json());
+            if (data.ok && data.result) {
+                for (const update of data.result) {
+                    this.offset = update.update_id + 1;
+                    this.handleUpdate(update);
+                }
+            }
+        }
+        catch (err) {
+            if (err instanceof Error && err.name === 'AbortError') {
+                return; // Intentional stop
+            }
+            // Network error — retry after delay
+        }
+        if (this.polling) {
+            this.pollTimer = setTimeout(() => this.poll(), 1_000);
+        }
+    }
+    handleUpdate(update) {
+        // SECURITY: Reject messages from unauthorized chats
+        const incomingChatId = String(update.message?.chat.id ??
+            update.channel_post?.chat.id ??
+            update.callback_query?.message?.chat.id ?? '');
+        if (this.allowedChatId && incomingChatId !== this.allowedChatId)
+            return;
+        // Handle text messages (DMs, groups, supergroups)
+        if (update.message?.text) {
+            const chatId = String(update.message.chat.id);
+            const chatType = update.message.chat.type || 'private';
+            const text = update.message.text;
+            const entities = update.message.entities || [];
+            const username = update.message.from?.username || update.message.from?.first_name || update.message.chat.first_name;
+            // In groups/supergroups: only respond to @mentions or /commands directed at this bot
+            if (chatType === 'group' || chatType === 'supergroup') {
+                const isBotMentioned = this.isMentionedInMessage(text, entities);
+                const isBotCommand = this.isCommandForBot(text, entities);
+                if (!isBotMentioned && !isBotCommand)
+                    return;
+                const cleanText = this.stripBotMention(text, entities);
+                this.onMessage?.(cleanText, chatId, username);
+                return;
+            }
+            // DMs: process everything (no @mention needed)
+            this.onMessage?.(text, chatId, username);
+        }
+        // Handle channel posts
+        if (update.channel_post?.text) {
+            const chatId = String(update.channel_post.chat.id);
+            const text = update.channel_post.text;
+            const entities = update.channel_post.entities || [];
+            const isBotMentioned = this.isMentionedInMessage(text, entities);
+            const isBotCommand = this.isCommandForBot(text, entities);
+            if (!isBotMentioned && !isBotCommand)
+                return;
+            const cleanText = this.stripBotMention(text, entities);
+            this.onMessage?.(cleanText, chatId, 'channel');
+        }
+        // Handle callback queries (inline button presses)
+        if (update.callback_query?.data) {
+            const chatId = String(update.callback_query.message?.chat.id || '');
+            this.onCallback?.(update.callback_query.data, chatId, update.callback_query.id);
+        }
+    }
+    /**
+     * Check if the bot is @mentioned in a message.
+     */
+    isMentionedInMessage(text, entities) {
+        if (!this.botUsername)
+            return false;
+        // Check for @mention entities from Telegram
+        for (const entity of entities) {
+            if (entity.type === 'mention') {
+                const mention = text.slice(entity.offset, entity.offset + entity.length).toLowerCase();
+                if (mention === `@${this.botUsername}`)
+                    return true;
+            }
+        }
+        // Fallback: raw text search for @botname (case-insensitive)
+        return text.toLowerCase().includes(`@${this.botUsername}`);
+    }
+    /**
+     * Check if a /command is directed at this bot (e.g. /status@botname).
+     */
+    isCommandForBot(text, entities) {
+        for (const entity of entities) {
+            if (entity.type === 'bot_command') {
+                const cmd = text.slice(entity.offset, entity.offset + entity.length).toLowerCase();
+                // /command (no @suffix → directed at all bots, accept in allowed chat)
+                if (!cmd.includes('@'))
+                    return true;
+                // /command@botname → only if it's our bot
+                if (this.botUsername && cmd.endsWith(`@${this.botUsername}`))
+                    return true;
+                return false;
+            }
+        }
+        // No bot_command entity but starts with / — accept (private chat)
+        return text.trim().startsWith('/');
+    }
+    /**
+     * Strip the @botname mention from the text so handlers get clean input.
+     * Also strips @botname suffix from /commands (e.g. /task@mybot → /task).
+     */
+    stripBotMention(text, entities) {
+        if (!this.botUsername)
+            return text;
+        let clean = text;
+        // Remove @botname from /commands (e.g. /status@jarvis_bot → /status)
+        const botSuffix = new RegExp(`@${this.botUsername}`, 'gi');
+        clean = clean.replace(botSuffix, '').trim();
+        return clean;
+    }
+    async apiCall(method, body) {
+        const res = await fetch(`https://api.telegram.org/bot${this.token}/${method}`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: body ? JSON.stringify(body) : undefined,
+            signal: AbortSignal.timeout(10_000),
+        });
+        return res.json();
+    }
+}
+/**
+ * Built-in command handler for the Telegram bot.
+ * Parses /commands and dispatches to Jarvis actions.
+ */
+export function parseTelegramCommand(text) {
+    const trimmed = text.trim();
+    if (!trimmed.startsWith('/')) {
+        return { command: null, args: trimmed };
+    }
+    const spaceIdx = trimmed.indexOf(' ');
+    if (spaceIdx === -1) {
+        return { command: trimmed.slice(1).toLowerCase(), args: '' };
+    }
+    return {
+        command: trimmed.slice(1, spaceIdx).toLowerCase(),
+        args: trimmed.slice(spaceIdx + 1).trim(),
+    };
+}
+//# sourceMappingURL=telegram-bot.js.map

package/dist/cli/jarvis/telegram-bot.js.map

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

package/dist/cli/jarvis/telemetry.d.ts

@@ -0,0 +1,32 @@
+import type { PrivacyLevel, TelemetryPayload, AnonymizedLearning, LearningEntry, SkillEffectiveness } from './types.js';
+export declare class TelemetryManager {
+    private configPath;
+    private installId;
+    private privacyLevel;
+    private enabled;
+    private lastSyncAt;
+    private serverUrl;
+    constructor(projectRoot: string, serverUrl?: string);
+    private loadConfig;
+    private saveConfig;
+    collectPayload(learnings: LearningEntry[], skillEffectiveness: SkillEffectiveness[], toolUsage?: Record<string, number>, errorPatterns?: Record<string, number>): TelemetryPayload | null;
+    sync(payload: TelemetryPayload): Promise<boolean>;
+    fetchCommunityLearnings(): Promise<AnonymizedLearning[]>;
+    setEnabled(enabled: boolean): void;
+    setPrivacyLevel(level: PrivacyLevel): void;
+    getConfig(): {
+        enabled: boolean;
+        privacyLevel: PrivacyLevel;
+        installId: string;
+        lastSyncAt: number;
+    };
+    isEnabled(): boolean;
+    anonymizeLearning(entry: LearningEntry): AnonymizedLearning;
+    anonymizeErrorPattern(error: string): string;
+    anonymizePath(path: string): string;
+    private anonymizeSolution;
+    private anonymizeContext;
+    private looksLikePath;
+    private looksLikeName;
+}
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/cli/jarvis/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../../src/cli/jarvis/telemetry.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAClD,aAAa,EAAE,kBAAkB,EAClC,MAAM,YAAY,CAAC;AA0BpB,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAS;gBAEd,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;IAanD,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,UAAU;IAelB,cAAc,CACZ,SAAS,EAAE,aAAa,EAAE,EAC1B,kBAAkB,EAAE,kBAAkB,EAAE,EACxC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAClC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACrC,gBAAgB,GAAG,IAAI;IA6CpB,IAAI,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;IAmBjD,uBAAuB,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAiB9D,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAKlC,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAK1C,SAAS,IAAI;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,YAAY,EAAE,YAAY,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE;IASpG,SAAS,IAAI,OAAO;IAMpB,iBAAiB,CAAC,KAAK,EAAE,aAAa,GAAG,kBAAkB;IAW3D,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAa5C,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAOnC,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,gBAAgB;IAUxB,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,aAAa;CAItB"}

package/dist/cli/jarvis/telemetry.js

@@ -0,0 +1,213 @@
+/**
+ * Jarvis Telemetry Manager — Opt-in anonymized data collection + community learnings.
+ * Stores config in .helixmind/jarvis/telemetry-config.json.
+ * All data is privacy-level gated and anonymized before transmission.
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs';
+import { join, dirname, extname } from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { platform } from 'node:os';
+let helixmindVersion = '0.0.0';
+try {
+    const { createRequire } = await import('node:module');
+    const require = createRequire(import.meta.url);
+    const pkg = require('../../../package.json');
+    helixmindVersion = pkg.version;
+}
+catch { /* fallback */ }
+const DEFAULT_CONFIG = () => ({
+    version: 1,
+    installId: randomUUID(),
+    enabled: false,
+    privacyLevel: 0,
+    lastSyncAt: 0,
+});
+export class TelemetryManager {
+    configPath;
+    installId;
+    privacyLevel;
+    enabled;
+    lastSyncAt;
+    serverUrl;
+    constructor(projectRoot, serverUrl) {
+        this.configPath = join(projectRoot, '.helixmind', 'jarvis', 'telemetry-config.json');
+        this.serverUrl = serverUrl || 'https://helixmind.dev/api/telemetry';
+        const config = this.loadConfig();
+        this.installId = config.installId;
+        this.enabled = config.enabled;
+        this.privacyLevel = config.privacyLevel;
+        this.lastSyncAt = config.lastSyncAt;
+    }
+    // ─── Config Persistence ───────────────────────────────────────────────
+    loadConfig() {
+        try {
+            if (existsSync(this.configPath)) {
+                const raw = readFileSync(this.configPath, 'utf-8');
+                const parsed = JSON.parse(raw);
+                if (parsed.version === 1 && parsed.installId)
+                    return parsed;
+            }
+        }
+        catch { /* corrupted — start fresh */ }
+        return DEFAULT_CONFIG();
+    }
+    saveConfig() {
+        const dir = dirname(this.configPath);
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+        const config = {
+            version: 1,
+            installId: this.installId,
+            enabled: this.enabled,
+            privacyLevel: this.privacyLevel,
+            lastSyncAt: this.lastSyncAt,
+        };
+        writeFileSync(this.configPath, JSON.stringify(config, null, 2), 'utf-8');
+    }
+    // ─── Payload Collection ───────────────────────────────────────────────
+    collectPayload(learnings, skillEffectiveness, toolUsage, errorPatterns) {
+        if (!this.enabled || this.privacyLevel === 0)
+            return null;
+        const payload = {
+            installId: this.installId,
+            privacyLevel: this.privacyLevel,
+            helixmindVersion,
+            nodeVersion: process.version,
+            os: platform(),
+            timestamp: Date.now(),
+        };
+        // Level 1+: tool usage counts and error pattern counts
+        if (this.privacyLevel >= 1) {
+            if (toolUsage)
+                payload.toolUsage = { ...toolUsage };
+            if (errorPatterns) {
+                payload.errorPatterns = Object.fromEntries(Object.entries(errorPatterns).map(([k, v]) => [this.anonymizeErrorPattern(k), v]));
+            }
+        }
+        // Level 2+: anonymized learnings and skill effectiveness
+        if (this.privacyLevel >= 2) {
+            payload.learnings = learnings.map(e => this.anonymizeLearning(e));
+            payload.skillEffectiveness = skillEffectiveness.map(s => ({
+                skillName: s.skillName,
+                timesUsed: s.timesUsed,
+                timesSuccessful: s.timesSuccessful,
+                avgQualityDelta: s.avgQualityDelta,
+                lastUsedAt: s.lastUsedAt,
+            }));
+        }
+        // Level 3: completion rates + orchestration patterns (passed via errorPatterns/toolUsage convention)
+        // These would be populated by the caller at level 3
+        if (this.privacyLevel >= 3) {
+            payload.completionRates = toolUsage ? { ...toolUsage } : undefined;
+        }
+        return payload;
+    }
+    // ─── Network ──────────────────────────────────────────────────────────
+    async sync(payload) {
+        try {
+            const response = await fetch(this.serverUrl, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify(payload),
+                signal: AbortSignal.timeout(10_000),
+            });
+            if (response.ok) {
+                this.lastSyncAt = Date.now();
+                this.saveConfig();
+                return true;
+            }
+            return false;
+        }
+        catch {
+            return false;
+        }
+    }
+    async fetchCommunityLearnings() {
+        try {
+            const response = await fetch(`${this.serverUrl}/community`, {
+                method: 'GET',
+                headers: { 'Accept': 'application/json' },
+                signal: AbortSignal.timeout(10_000),
+            });
+            if (!response.ok)
+                return [];
+            const data = await response.json();
+            return Array.isArray(data.learnings) ? data.learnings : [];
+        }
+        catch {
+            return [];
+        }
+    }
+    // ─── Configuration ────────────────────────────────────────────────────
+    setEnabled(enabled) {
+        this.enabled = enabled;
+        this.saveConfig();
+    }
+    setPrivacyLevel(level) {
+        this.privacyLevel = level;
+        this.saveConfig();
+    }
+    getConfig() {
+        return {
+            enabled: this.enabled,
+            privacyLevel: this.privacyLevel,
+            installId: this.installId,
+            lastSyncAt: this.lastSyncAt,
+        };
+    }
+    isEnabled() {
+        return this.enabled && this.privacyLevel > 0;
+    }
+    // ─── Anonymization ────────────────────────────────────────────────────
+    anonymizeLearning(entry) {
+        return {
+            category: entry.category,
+            errorPattern: this.anonymizeErrorPattern(entry.errorPattern),
+            solution: this.anonymizeSolution(entry.solution),
+            context: this.anonymizeContext(entry.context),
+            confidence: entry.confidence,
+            tags: entry.tags.filter(t => !this.looksLikePath(t) && !this.looksLikeName(t)),
+        };
+    }
+    anonymizeErrorPattern(error) {
+        return error
+            .replace(/\/[\w\-./]+/g, '<path>') // Unix paths
+            .replace(/[A-Z]:\\[\w\-.\\/]+/gi, '<path>') // Windows paths
+            .replace(/:\d+:\d+/g, ':<line>') // line:col
+            .replace(/\b\d{10,13}\b/g, '<timestamp>') // timestamps
+            .replace(/\b[a-zA-Z][\w-]*(?:\.[\w-]+){2,}/g, '<name>') // dotted names (packages)
+            .replace(/['"][^'"]{30,}['"]/g, '"<string>"') // long string literals
+            .replace(/\s+/g, ' ')
+            .trim()
+            .slice(0, 200);
+    }
+    anonymizePath(path) {
+        const ext = extname(path);
+        return ext || '<no-ext>';
+    }
+    // ─── Private Helpers ──────────────────────────────────────────────────
+    anonymizeSolution(solution) {
+        return solution
+            .replace(/\/[\w\-./]+/g, '<path>')
+            .replace(/[A-Z]:\\[\w\-.\\/]+/gi, '<path>')
+            .replace(/`[^`]{50,}`/g, '`<code>`') // long code snippets in backticks
+            .replace(/\b[a-f0-9]{8,}\b/gi, '<hash>') // hashes
+            .trim()
+            .slice(0, 300);
+    }
+    anonymizeContext(context) {
+        // Keep only tool name + file extension
+        const parts = context.split(/\s+/);
+        const safe = parts.filter(p => p.startsWith('.') || // file extension
+            /^[a-z_]+$/.test(p));
+        return safe.join(' ') || 'unknown';
+    }
+    looksLikePath(value) {
+        return /[/\\]/.test(value) || /^[A-Z]:\\/i.test(value);
+    }
+    looksLikeName(value) {
+        // Filter out things that look like project/user names
+        return /^[A-Z][a-z]+[A-Z]/.test(value); // CamelCase proper nouns
+    }
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/cli/jarvis/telemetry.js.map

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

package/dist/cli/jarvis/test-sentinel.d.ts

@@ -0,0 +1,36 @@
+import type { ProposalEvidence } from './types.js';
+export interface TestInsight {
+    type: 'affected_tests' | 'flaky_test' | 'coverage_drop' | 'missing_tests';
+    description: string;
+    severity: 'low' | 'medium' | 'high';
+    files?: string[];
+    suggestion?: string;
+}
+/**
+ * Detect which test files are likely affected by recent changes.
+ * Uses import/require graph heuristics from git diff.
+ */
+export declare function detectAffectedTests(projectRoot: string): TestInsight[];
+/**
+ * Check for flaky tests by looking at recent test history.
+ * Reads .helixmind/test-history.json if it exists.
+ */
+export declare function detectFlakyTests(projectRoot: string): TestInsight[];
+/**
+ * Run a quick test suite status check (vitest --reporter=json).
+ * Non-blocking: returns null if tests take too long.
+ */
+export declare function getTestSuiteStatus(projectRoot: string): {
+    passed: number;
+    failed: number;
+    total: number;
+} | null;
+/**
+ * Build test insights for the thinking loop.
+ */
+export declare function runTestAnalysis(projectRoot: string): TestInsight[];
+/**
+ * Convert test insights to proposal evidence.
+ */
+export declare function insightsToEvidence(insights: TestInsight[]): ProposalEvidence[];
+//# sourceMappingURL=test-sentinel.d.ts.map

package/dist/cli/jarvis/test-sentinel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-sentinel.d.ts","sourceRoot":"","sources":["../../../src/cli/jarvis/test-sentinel.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,gBAAgB,GAAG,YAAY,GAAG,eAAe,GAAG,eAAe,CAAC;IAC1E,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,EAAE,CAyFtE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,EAAE,CA0CnE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAuBhH;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,EAAE,CAKlE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,gBAAgB,EAAE,CAM9E"}