@kernel.chat/kbot 3.39.0 → 3.41.0

package/dist/interactive-buttons.d.ts

@@ -0,0 +1,90 @@
+/** Button style options */
+export type ButtonStyle = 'primary' | 'secondary' | 'success' | 'danger' | 'link';
+/** A single button action definition */
+export interface ButtonAction {
+    label: string;
+    action: string;
+    style?: ButtonStyle;
+}
+/** A registered pending action */
+export interface PendingAction {
+    token: string;
+    action: string;
+    callback_description: string;
+    created_at: string;
+    expires_at: string;
+    executed: boolean;
+    executed_at: string | null;
+}
+/** Discord button component (webhook format) */
+interface DiscordButton {
+    type: 2;
+    style: number;
+    label: string;
+    custom_id?: string;
+    url?: string;
+}
+/** Discord action row */
+interface DiscordActionRow {
+    type: 1;
+    components: DiscordButton[];
+}
+/** Discord embed */
+export interface DiscordEmbed {
+    title?: string;
+    description?: string;
+    color?: number;
+    fields?: Array<{
+        name: string;
+        value: string;
+        inline?: boolean;
+    }>;
+    footer?: {
+        text: string;
+    };
+    timestamp?: string;
+}
+/** Button set result for different platforms */
+export interface ButtonSet {
+    discord: DiscordActionRow;
+    email_html: string;
+    slack_blocks: unknown[];
+}
+/**
+ * Create a formatted button set for different platforms.
+ * Registers each action and generates platform-specific markup.
+ */
+export declare function createButtonSet(actions: ButtonAction[]): ButtonSet;
+/**
+ * Send an email via Resend with clickable action buttons at the bottom.
+ * Requires RESEND_API_KEY in environment.
+ */
+export declare function createEmailWithButtons(to: string, subject: string, body: string, buttons: ButtonAction[]): Promise<{
+    sent: boolean;
+    message_id: string | null;
+    error: string | null;
+}>;
+/**
+ * Send a Discord message with interactive button components.
+ */
+export declare function createDiscordWithButtons(webhookUrl: string, embed: DiscordEmbed, buttons: ButtonAction[]): Promise<{
+    sent: boolean;
+    error: string | null;
+}>;
+/**
+ * Process a button click action.
+ * Reads the action from pending-actions, marks it as executed.
+ */
+export declare function handleButtonAction(token: string, action: string): {
+    handled: boolean;
+    action: string;
+    callback_description: string;
+    error: string | null;
+};
+/**
+ * Register an action with a unique token.
+ * Saves to ~/.kbot/pending-actions/. Expires after 72 hours.
+ */
+export declare function registerAction(action: string, callback_description: string): string;
+export {};
+//# sourceMappingURL=interactive-buttons.d.ts.map

package/dist/interactive-buttons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive-buttons.d.ts","sourceRoot":"","sources":["../src/interactive-buttons.ts"],"names":[],"mappings":"AAqBA,2BAA2B;AAC3B,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAA;AAEjF,wCAAwC;AACxC,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,WAAW,CAAA;CACpB;AAED,kCAAkC;AAClC,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,oBAAoB,EAAE,MAAM,CAAA;IAC5B,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,OAAO,CAAA;IACjB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAC3B;AAED,gDAAgD;AAChD,UAAU,aAAa;IACrB,IAAI,EAAE,CAAC,CAAA;IACP,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED,yBAAyB;AACzB,UAAU,gBAAgB;IACxB,IAAI,EAAE,CAAC,CAAA;IACP,UAAU,EAAE,aAAa,EAAE,CAAA;CAC5B;AAED,oBAAoB;AACpB,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;IACjE,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,gDAAgD;AAChD,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,gBAAgB,CAAA;IACzB,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,OAAO,EAAE,CAAA;CACxB;AAkCD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,SAAS,CAoDlE;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,YAAY,EAAE,GACtB,OAAO,CAAC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAiD7E;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,YAAY,EAAE,GACtB,OAAO,CAAC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CA6ClD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb;IACD,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,oBAAoB,EAAE,MAAM,CAAA;IAC5B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB,CA0CA;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,GAAG,MAAM,CAuBnF"}

package/dist/interactive-buttons.js

@@ -0,0 +1,286 @@
+// kbot Interactive Response Buttons
+//
+// When kbot sends emails or Discord messages, include action buttons.
+// Buttons link to response endpoints that trigger follow-up actions.
+//
+// Supports: Discord (webhook), Email (Resend), Slack (Block Kit, future)
+//
+// Pending actions stored at: ~/.kbot/pending-actions/
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { existsSync, readFileSync, writeFileSync, mkdirSync, readdirSync, rmSync, } from 'node:fs';
+import { randomUUID } from 'node:crypto';
+const PENDING_DIR = join(homedir(), '.kbot', 'pending-actions');
+const ACTION_EXPIRY_MS = 72 * 60 * 60 * 1000; // 72 hours
+const ACTION_BASE_URL = 'https://kernel.chat/api/action';
+function ensureDir() {
+    if (!existsSync(PENDING_DIR))
+        mkdirSync(PENDING_DIR, { recursive: true });
+}
+function actionPath(token) {
+    return join(PENDING_DIR, `${token}.json`);
+}
+/** Map ButtonStyle to Discord button style number */
+function discordStyleNumber(style) {
+    const map = {
+        primary: 1,
+        secondary: 2,
+        success: 3,
+        danger: 4,
+        link: 5,
+    };
+    return map[style] || 2;
+}
+/** Map ButtonStyle to email button color */
+function emailButtonColor(style) {
+    const map = {
+        primary: '#6B5B95',
+        secondary: '#6c757d',
+        success: '#28a745',
+        danger: '#dc3545',
+        link: '#007bff',
+    };
+    return map[style] || '#6B5B95';
+}
+/**
+ * Create a formatted button set for different platforms.
+ * Registers each action and generates platform-specific markup.
+ */
+export function createButtonSet(actions) {
+    // Register actions and get tokens
+    const registeredActions = actions.map(a => ({
+        ...a,
+        token: registerAction(a.action, `Button: ${a.label}`),
+    }));
+    // Discord: action row with buttons
+    const discordButtons = registeredActions.map(a => ({
+        type: 2,
+        style: discordStyleNumber(a.style || 'primary'),
+        label: a.label,
+        // For link style, use URL; otherwise use custom_id
+        ...(a.style === 'link'
+            ? { url: `${ACTION_BASE_URL}?token=${a.token}&action=${encodeURIComponent(a.action)}` }
+            : { custom_id: `kbot_action_${a.token}` }),
+    }));
+    const discord = {
+        type: 1,
+        components: discordButtons,
+    };
+    // Email: HTML buttons
+    const emailButtons = registeredActions.map(a => {
+        const color = emailButtonColor(a.style || 'primary');
+        const url = `${ACTION_BASE_URL}?token=${a.token}&action=${encodeURIComponent(a.action)}`;
+        return `<a href="${url}" style="display:inline-block;padding:10px 24px;margin:4px 8px 4px 0;background-color:${color};color:#ffffff;text-decoration:none;border-radius:6px;font-family:'Courier Prime',monospace;font-size:14px;font-weight:bold;">${escapeHtml(a.label)}</a>`;
+    });
+    const email_html = `<div style="margin-top:24px;padding-top:16px;border-top:1px solid #e5e5e5;">${emailButtons.join('\n')}</div>`;
+    // Slack: Block Kit buttons (future use)
+    const slack_blocks = [
+        {
+            type: 'actions',
+            elements: registeredActions.map(a => ({
+                type: 'button',
+                text: {
+                    type: 'plain_text',
+                    text: a.label,
+                    emoji: true,
+                },
+                action_id: `kbot_${a.action}`,
+                value: a.token,
+                ...(a.style === 'danger' ? { style: 'danger' } : {}),
+                ...(a.style === 'primary' ? { style: 'primary' } : {}),
+            })),
+        },
+    ];
+    return { discord, email_html, slack_blocks };
+}
+/**
+ * Send an email via Resend with clickable action buttons at the bottom.
+ * Requires RESEND_API_KEY in environment.
+ */
+export async function createEmailWithButtons(to, subject, body, buttons) {
+    const apiKey = process.env.RESEND_API_KEY;
+    if (!apiKey) {
+        return { sent: false, message_id: null, error: 'RESEND_API_KEY not configured' };
+    }
+    const buttonSet = createButtonSet(buttons);
+    const htmlBody = `
+<!DOCTYPE html>
+<html>
+<head><meta charset="utf-8"></head>
+<body style="font-family:'EB Garamond','Georgia',serif;color:#1a1a1a;background-color:#FFFFF0;padding:32px;max-width:600px;margin:0 auto;">
+  <div style="font-family:'Courier Prime',monospace;font-size:12px;color:#6B5B95;text-transform:uppercase;letter-spacing:2px;margin-bottom:16px;">kernel.chat</div>
+  <h2 style="font-family:'EB Garamond','Georgia',serif;margin:0 0 16px 0;">${escapeHtml(subject)}</h2>
+  <div style="line-height:1.6;">${body}</div>
+  ${buttonSet.email_html}
+  <div style="margin-top:32px;padding-top:16px;border-top:1px solid #e5e5e5;font-size:12px;color:#999;">
+    Sent by kbot &mdash; <a href="https://kernel.chat" style="color:#6B5B95;">kernel.chat</a>
+  </div>
+</body>
+</html>`;
+    try {
+        const res = await fetch('https://api.resend.com/emails', {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${apiKey}`,
+            },
+            body: JSON.stringify({
+                from: 'kbot <noreply@kernel.chat>',
+                to: [to],
+                subject,
+                html: htmlBody,
+            }),
+            signal: AbortSignal.timeout(15_000),
+        });
+        if (!res.ok) {
+            const errText = await res.text();
+            return { sent: false, message_id: null, error: `Resend API error: ${res.status} ${errText}` };
+        }
+        const result = await res.json();
+        return { sent: true, message_id: result.id || null, error: null };
+    }
+    catch (err) {
+        return { sent: false, message_id: null, error: err.message };
+    }
+}
+/**
+ * Send a Discord message with interactive button components.
+ */
+export async function createDiscordWithButtons(webhookUrl, embed, buttons) {
+    const buttonSet = createButtonSet(buttons);
+    // For webhook-based messages, buttons must use link style (URL buttons)
+    // since webhooks can't receive interaction callbacks
+    const linkButtons = buttons.map(b => {
+        const token = registerAction(b.action, `Discord button: ${b.label}`);
+        return {
+            type: 2,
+            style: 5, // Link style for webhook messages
+            label: b.label,
+            url: `${ACTION_BASE_URL}?token=${token}&action=${encodeURIComponent(b.action)}`,
+        };
+    });
+    const actionRow = {
+        type: 1,
+        components: linkButtons,
+    };
+    const payload = {
+        embeds: [embed],
+        components: [actionRow],
+    };
+    // Use buttonSet to suppress unused variable — Slack blocks stored for future
+    void buttonSet.slack_blocks;
+    try {
+        const res = await fetch(webhookUrl, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(payload),
+            signal: AbortSignal.timeout(15_000),
+        });
+        if (!res.ok) {
+            const errText = await res.text();
+            return { sent: false, error: `Discord webhook error: ${res.status} ${errText}` };
+        }
+        return { sent: true, error: null };
+    }
+    catch (err) {
+        return { sent: false, error: err.message };
+    }
+}
+/**
+ * Process a button click action.
+ * Reads the action from pending-actions, marks it as executed.
+ */
+export function handleButtonAction(token, action) {
+    ensureDir();
+    const path = actionPath(token);
+    if (!existsSync(path)) {
+        return { handled: false, action, callback_description: '', error: 'Action token not found' };
+    }
+    let pending;
+    try {
+        pending = JSON.parse(readFileSync(path, 'utf-8'));
+    }
+    catch {
+        return { handled: false, action, callback_description: '', error: 'Failed to read action' };
+    }
+    // Check if expired
+    if (new Date(pending.expires_at).getTime() < Date.now()) {
+        rmSync(path);
+        return { handled: false, action, callback_description: pending.callback_description, error: 'Action expired' };
+    }
+    // Check if already executed
+    if (pending.executed) {
+        return { handled: false, action, callback_description: pending.callback_description, error: 'Action already executed' };
+    }
+    // Verify action matches
+    if (pending.action !== action) {
+        return { handled: false, action, callback_description: pending.callback_description, error: 'Action mismatch' };
+    }
+    // Mark as executed
+    pending.executed = true;
+    pending.executed_at = new Date().toISOString();
+    writeFileSync(path, JSON.stringify(pending, null, 2));
+    return {
+        handled: true,
+        action: pending.action,
+        callback_description: pending.callback_description,
+        error: null,
+    };
+}
+/**
+ * Register an action with a unique token.
+ * Saves to ~/.kbot/pending-actions/. Expires after 72 hours.
+ */
+export function registerAction(action, callback_description) {
+    ensureDir();
+    const token = randomUUID();
+    const now = new Date();
+    const expires = new Date(now.getTime() + ACTION_EXPIRY_MS);
+    const pending = {
+        token,
+        action,
+        callback_description,
+        created_at: now.toISOString(),
+        expires_at: expires.toISOString(),
+        executed: false,
+        executed_at: null,
+    };
+    writeFileSync(actionPath(token), JSON.stringify(pending, null, 2));
+    // Prune expired actions in the background
+    pruneExpiredActions();
+    return token;
+}
+/** Remove expired pending actions */
+function pruneExpiredActions() {
+    ensureDir();
+    try {
+        const files = readdirSync(PENDING_DIR).filter(f => f.endsWith('.json'));
+        const now = Date.now();
+        for (const file of files) {
+            const path = join(PENDING_DIR, file);
+            try {
+                const pending = JSON.parse(readFileSync(path, 'utf-8'));
+                if (new Date(pending.expires_at).getTime() < now) {
+                    rmSync(path);
+                }
+            }
+            catch {
+                // Corrupt file — remove it
+                rmSync(path, { force: true });
+            }
+        }
+    }
+    catch {
+        // Non-critical — pruning can fail silently
+    }
+}
+/** Escape HTML special characters */
+function escapeHtml(text) {
+    return text
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#39;');
+}
+//# sourceMappingURL=interactive-buttons.js.map

package/dist/interactive-buttons.js.map

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

package/dist/knowledge-base.d.ts

@@ -0,0 +1,95 @@
+export type KnowledgeSource = 'conversation' | 'forge' | 'pattern' | 'web_search' | 'user_question' | 'email' | 'manual';
+export interface KnowledgeEntry {
+    /** Unique ID (SHA-256 hash of content + source) */
+    id: string;
+    /** Primary topic this entry belongs to */
+    topic: string;
+    /** The actual knowledge content */
+    content: string;
+    /** Where this knowledge came from */
+    source: KnowledgeSource;
+    /** Source detail (e.g., tool name, email subject, URL) */
+    sourceDetail: string;
+    /** Confidence in this knowledge (0-1) */
+    confidence: number;
+    /** Tags for cross-referencing */
+    tags: string[];
+    /** When this entry was created */
+    createdAt: string;
+    /** When this entry was last verified/updated */
+    updatedAt: string;
+}
+export interface KnowledgeIndex {
+    /** Total number of entries across all topics */
+    totalEntries: number;
+    /** Map of topic slug -> entry count */
+    topics: Record<string, number>;
+    /** Map of source type -> entry count */
+    sources: Record<string, number>;
+    /** Last time the index was updated */
+    lastUpdated: string;
+}
+export interface KnowledgeQueryResult {
+    /** The matching entry */
+    entry: KnowledgeEntry;
+    /** Relevance score (higher = more relevant) */
+    relevance: number;
+}
+export interface KnowledgeStats {
+    total_entries: number;
+    topics: string[];
+    sources: Record<string, number>;
+    last_updated: string;
+}
+export declare class KnowledgeBase {
+    private indexCache;
+    constructor();
+    /**
+     * Add knowledge from any source.
+     * Deduplicates by content hash.
+     * Tags with source, confidence, timestamp.
+     */
+    ingest(source: KnowledgeSource, content: string, metadata?: {
+        topic?: string;
+        sourceDetail?: string;
+        confidence?: number;
+        tags?: string[];
+    }): KnowledgeEntry;
+    /**
+     * Search the knowledge base for relevant entries.
+     * Uses keyword matching + cosine similarity on TF-IDF vectors.
+     * Returns ranked results with sources.
+     */
+    query(question: string): KnowledgeQueryResult[];
+    /**
+     * Get everything kbot knows about a topic, synthesized into a readable summary.
+     * Pulls from all sources and organizes by type.
+     */
+    getTopicSummary(topic: string): string;
+    /**
+     * Extract knowledge from an email/conversation thread.
+     * Pulls out facts, decisions, recommendations.
+     */
+    addFromConversation(userEmail: string, messages: Array<{
+        role: string;
+        content: string;
+    }>): KnowledgeEntry[];
+    /**
+     * When a tool is forged, extract what problem it solves and add to KB.
+     */
+    addFromForge(tool: {
+        name: string;
+        description: string;
+        tags?: string[];
+        code?: string;
+    }): KnowledgeEntry;
+    /**
+     * Get knowledge base statistics.
+     */
+    getStats(): KnowledgeStats;
+    /** Load or rebuild the index */
+    private loadIndex;
+    /** Rebuild the index from all topic files */
+    private rebuildIndex;
+}
+//# sourceMappingURL=knowledge-base.d.ts.map

package/dist/knowledge-base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-base.d.ts","sourceRoot":"","sources":["../src/knowledge-base.ts"],"names":[],"mappings":"AAyBA,MAAM,MAAM,eAAe,GACvB,cAAc,GACd,OAAO,GACP,SAAS,GACT,YAAY,GACZ,eAAe,GACf,OAAO,GACP,QAAQ,CAAA;AAEZ,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,EAAE,EAAE,MAAM,CAAA;IACV,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAA;IACb,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAA;IACf,qCAAqC;IACrC,MAAM,EAAE,eAAe,CAAA;IACvB,0DAA0D;IAC1D,YAAY,EAAE,MAAM,CAAA;IACpB,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAA;IAClB,iCAAiC;IACjC,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAA;IACjB,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,gDAAgD;IAChD,YAAY,EAAE,MAAM,CAAA;IACpB,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,yBAAyB;IACzB,KAAK,EAAE,cAAc,CAAA;IACrB,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,CAAA;IACrB,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,YAAY,EAAE,MAAM,CAAA;CACrB;AA+MD,qBAAa,aAAa;IACxB,OAAO,CAAC,UAAU,CAA8B;;IAMhD;;;;OAIG;IACH,MAAM,CACJ,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE;QACT,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,YAAY,CAAC,EAAE,MAAM,CAAA;QACrB,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;KAChB,GACA,cAAc;IA8CjB;;;;OAIG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,oBAAoB,EAAE;IAkD/C;;;OAGG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAsFtC;;;OAGG;IACH,mBAAmB,CACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,GACjD,cAAc,EAAE;IAuBnB;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE;QACjB,IAAI,EAAE,MAAM,CAAA;QACZ,WAAW,EAAE,MAAM,CAAA;QACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;QACf,IAAI,CAAC,EAAE,MAAM,CAAA;KACd,GAAG,cAAc;IAgBlB;;OAEG;IACH,QAAQ,IAAI,cAAc;IAa1B,gCAAgC;IAChC,OAAO,CAAC,SAAS;IAWjB,6CAA6C;IAC7C,OAAO,CAAC,YAAY;CAuCrB"}