@soleri/core 2.10.0 → 2.12.0

package/dist/chat/mcp-bridge.js

@@ -0,0 +1,111 @@
+/**
+ * MCP Tool Bridge — intercepts MCP tool registrations and executes locally.
+ *
+ * Ported from Salvador's mcp-bridge.ts with improvements:
+ * - Simpler API (no Zod dependency — accepts JSON Schema directly)
+ * - Optional allowlist for tool filtering
+ * - Generic output compression hook
+ *
+ * Used by Telegram (and other chat transports) to bridge the agent's MCP tools
+ * into the agent loop without network round-trips.
+ */
+const DEFAULT_MAX_OUTPUT = 10_000; // 10KB
+export class McpToolBridge {
+    tools = new Map();
+    allowlist;
+    compressor;
+    maxOutput;
+    constructor(options) {
+        this.allowlist = options?.allowlist ? new Set(options.allowlist) : null;
+        this.compressor = options?.compressor ?? null;
+        this.maxOutput = options?.maxOutput ?? DEFAULT_MAX_OUTPUT;
+    }
+    /**
+     * Register a tool. If an allowlist is set, only allowed tools are registered.
+     */
+    register(tool) {
+        if (this.allowlist && !this.allowlist.has(tool.name))
+            return;
+        this.tools.set(tool.name, tool);
+    }
+    /**
+     * Register multiple tools at once.
+     */
+    registerAll(tools) {
+        for (const tool of tools) {
+            this.register(tool);
+        }
+    }
+    /**
+     * Check if a tool is registered.
+     */
+    has(name) {
+        return this.tools.has(name);
+    }
+    /**
+     * Get registered tools as AgentTool array (for the agent loop).
+     */
+    getTools() {
+        return [...this.tools.values()].map((t) => ({
+            name: t.name,
+            description: t.description,
+            inputSchema: t.inputSchema,
+        }));
+    }
+    /**
+     * Execute a tool by name.
+     */
+    async execute(name, input) {
+        const tool = this.tools.get(name);
+        if (!tool) {
+            return {
+                output: `Unknown tool: ${name}`,
+                isError: true,
+            };
+        }
+        try {
+            const rawResult = await tool.handler(input);
+            let output = typeof rawResult === 'string' ? rawResult : JSON.stringify(rawResult);
+            // Apply compression if available
+            if (this.compressor) {
+                output = this.compressor(name, output, this.maxOutput);
+            }
+            // Truncate if still too long
+            if (output.length > this.maxOutput) {
+                output = output.slice(0, this.maxOutput) + `\n... (truncated at ${this.maxOutput} chars)`;
+            }
+            return { output, isError: false };
+        }
+        catch (error) {
+            return {
+                output: `Tool error: ${error instanceof Error ? error.message : String(error)}`,
+                isError: true,
+            };
+        }
+    }
+    /**
+     * Create a ToolExecutor function for use with the agent loop.
+     */
+    createExecutor() {
+        return (name, input) => this.execute(name, input);
+    }
+    /**
+     * Number of registered tools.
+     */
+    get size() {
+        return this.tools.size;
+    }
+    /**
+     * List registered tool names.
+     */
+    listTools() {
+        return [...this.tools.keys()];
+    }
+    /**
+     * Clear all registered tools.
+     */
+    clear() {
+        this.tools.clear();
+    }
+}
+//# sourceMappingURL=mcp-bridge.js.map

package/dist/chat/mcp-bridge.js.map

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

package/dist/chat/notifications.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Notification Engine — pluggable background polling with debounce.
+ *
+ * Generic notification system for chat transports. Register check functions
+ * that run at configurable intervals. Built-in debounce prevents spam.
+ *
+ * Transport-specific delivery (Telegram, Discord, etc.) is handled via
+ * the onNotify callback.
+ */
+export interface NotificationCheck {
+    /** Unique check ID. */
+    id: string;
+    /** Human-readable label. */
+    label: string;
+    /** The check function. Returns null if nothing to notify, or a message string. */
+    check: () => Promise<string | null>;
+    /** Cooldown between notifications for this check (ms). Default: 4 hours. */
+    cooldownMs?: number;
+    /** Optional time window — only run during these hours (0-23). */
+    activeHours?: {
+        start: number;
+        end: number;
+    };
+}
+export interface NotificationEngineConfig {
+    /** Polling interval in ms. Default: 30 minutes. */
+    intervalMs?: number;
+    /** Callback to deliver a notification. */
+    onNotify: (checkId: string, message: string) => Promise<void>;
+    /** Default cooldown for checks that don't specify one. Default: 4 hours. */
+    defaultCooldownMs?: number;
+}
+export interface NotificationStats {
+    /** Number of registered checks. */
+    checks: number;
+    /** Whether the engine is running. */
+    running: boolean;
+    /** Total notifications sent. */
+    sent: number;
+    /** Last poll timestamp. */
+    lastPollAt: number | null;
+}
+export declare class NotificationEngine {
+    private checks;
+    private lastNotified;
+    private timer;
+    private sent;
+    private lastPollAt;
+    private readonly intervalMs;
+    private readonly defaultCooldownMs;
+    private readonly onNotify;
+    constructor(config: NotificationEngineConfig);
+    /**
+     * Register a notification check.
+     */
+    register(check: NotificationCheck): void;
+    /**
+     * Unregister a check.
+     */
+    unregister(id: string): boolean;
+    /**
+     * Start the polling loop. Runs an initial check after a short delay.
+     */
+    start(): void;
+    /**
+     * Stop the polling loop.
+     */
+    stop(): void;
+    /**
+     * Run all checks once (called automatically by the polling loop).
+     */
+    poll(): Promise<number>;
+    /**
+     * Get engine stats.
+     */
+    stats(): NotificationStats;
+    /**
+     * Check if enough time has passed since last notification for this check.
+     */
+    private shouldNotify;
+}
+//# sourceMappingURL=notifications.d.ts.map

package/dist/chat/notifications.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.d.ts","sourceRoot":"","sources":["../../src/chat/notifications.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,WAAW,iBAAiB;IAChC,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,kFAAkF;IAClF,KAAK,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACpC,4EAA4E;IAC5E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,WAAW,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9C;AAED,MAAM,WAAW,wBAAwB;IACvC,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,4EAA4E;IAC5E,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAOD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAwC;IACtD,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsD;gBAEnE,MAAM,EAAE,wBAAwB;IAM5C;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI;IAIxC;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI/B;;OAEG;IACH,KAAK,IAAI,IAAI;IASb;;OAEG;IACH,IAAI,IAAI,IAAI;IAOZ;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAsC7B;;OAEG;IACH,KAAK,IAAI,iBAAiB;IAS1B;;OAEG;IACH,OAAO,CAAC,YAAY;CAKrB"}

package/dist/chat/notifications.js

@@ -0,0 +1,119 @@
+/**
+ * Notification Engine — pluggable background polling with debounce.
+ *
+ * Generic notification system for chat transports. Register check functions
+ * that run at configurable intervals. Built-in debounce prevents spam.
+ *
+ * Transport-specific delivery (Telegram, Discord, etc.) is handled via
+ * the onNotify callback.
+ */
+// ─── Engine ───────────────────────────────────────────────────────────
+const DEFAULT_INTERVAL_MS = 30 * 60 * 1000; // 30 minutes
+const DEFAULT_COOLDOWN_MS = 4 * 60 * 60 * 1000; // 4 hours
+export class NotificationEngine {
+    checks = new Map();
+    lastNotified = new Map();
+    timer = null;
+    sent = 0;
+    lastPollAt = null;
+    intervalMs;
+    defaultCooldownMs;
+    onNotify;
+    constructor(config) {
+        this.intervalMs = config.intervalMs ?? DEFAULT_INTERVAL_MS;
+        this.defaultCooldownMs = config.defaultCooldownMs ?? DEFAULT_COOLDOWN_MS;
+        this.onNotify = config.onNotify;
+    }
+    /**
+     * Register a notification check.
+     */
+    register(check) {
+        this.checks.set(check.id, check);
+    }
+    /**
+     * Unregister a check.
+     */
+    unregister(id) {
+        return this.checks.delete(id);
+    }
+    /**
+     * Start the polling loop. Runs an initial check after a short delay.
+     */
+    start() {
+        if (this.timer)
+            return; // Already running
+        // Initial check after 10 seconds
+        setTimeout(() => this.poll(), 10_000);
+        this.timer = setInterval(() => this.poll(), this.intervalMs);
+    }
+    /**
+     * Stop the polling loop.
+     */
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+    }
+    /**
+     * Run all checks once (called automatically by the polling loop).
+     */
+    async poll() {
+        this.lastPollAt = Date.now();
+        let notified = 0;
+        for (const [id, check] of this.checks) {
+            try {
+                // Time window check
+                if (check.activeHours) {
+                    const hour = new Date().getHours();
+                    const { start, end } = check.activeHours;
+                    if (start <= end) {
+                        if (hour < start || hour >= end)
+                            continue;
+                    }
+                    else {
+                        // Wraps midnight (e.g., 22-6)
+                        if (hour < start && hour >= end)
+                            continue;
+                    }
+                }
+                // Cooldown check
+                if (!this.shouldNotify(id, check.cooldownMs ?? this.defaultCooldownMs)) {
+                    continue;
+                }
+                const message = await check.check();
+                if (message) {
+                    await this.onNotify(id, message);
+                    this.lastNotified.set(id, Date.now());
+                    this.sent++;
+                    notified++;
+                }
+            }
+            catch {
+                // Individual check failure is non-critical
+            }
+        }
+        return notified;
+    }
+    /**
+     * Get engine stats.
+     */
+    stats() {
+        return {
+            checks: this.checks.size,
+            running: this.timer !== null,
+            sent: this.sent,
+            lastPollAt: this.lastPollAt,
+        };
+    }
+    /**
+     * Check if enough time has passed since last notification for this check.
+     */
+    shouldNotify(checkId, cooldownMs) {
+        const last = this.lastNotified.get(checkId);
+        if (!last)
+            return true;
+        return Date.now() - last >= cooldownMs;
+    }
+}
+//# sourceMappingURL=notifications.js.map

package/dist/chat/notifications.js.map

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

package/dist/chat/output-compressor.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Output Compressor — compress verbose tool outputs for chat contexts.
+ *
+ * Unlike Salvador's 30+ domain-specific compressors, this provides:
+ * 1. A generic JSON compressor (extracts key fields, truncates arrays)
+ * 2. A registry for domain-specific compressors (pluggable)
+ *
+ * Domain packs can register their own compressors for their tools.
+ */
+import type { OutputCompressor } from './agent-loop-types.js';
+type ToolCompressor = (output: string, maxLength: number) => string;
+/**
+ * Register a compressor for a specific tool name (or prefix).
+ */
+export declare function registerCompressor(toolNameOrPrefix: string, compressor: ToolCompressor): void;
+/**
+ * Clear all registered compressors.
+ */
+export declare function clearCompressors(): void;
+/**
+ * Create a generic output compressor. Uses registered compressors for known tools,
+ * falls back to JSON-aware truncation.
+ */
+export declare function createOutputCompressor(options?: {
+    maxLength?: number;
+    maxArrayItems?: number;
+    maxStringLength?: number;
+}): OutputCompressor;
+export {};
+//# sourceMappingURL=output-compressor.d.ts.map

package/dist/chat/output-compressor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-compressor.d.ts","sourceRoot":"","sources":["../../src/chat/output-compressor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAQ9D,KAAK,cAAc,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;AAIpE;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,gBAAgB,EAAE,MAAM,EAAE,UAAU,EAAE,cAAc,GAAG,IAAI,CAE7F;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAID;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,CAAC,EAAE;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,GAAG,gBAAgB,CAiCnB"}

package/dist/chat/output-compressor.js

@@ -0,0 +1,95 @@
+/**
+ * Output Compressor — compress verbose tool outputs for chat contexts.
+ *
+ * Unlike Salvador's 30+ domain-specific compressors, this provides:
+ * 1. A generic JSON compressor (extracts key fields, truncates arrays)
+ * 2. A registry for domain-specific compressors (pluggable)
+ *
+ * Domain packs can register their own compressors for their tools.
+ */
+const DEFAULT_MAX_LENGTH = 4000;
+const DEFAULT_MAX_ARRAY_ITEMS = 5;
+const DEFAULT_MAX_STRING_LENGTH = 500;
+const compressorRegistry = new Map();
+/**
+ * Register a compressor for a specific tool name (or prefix).
+ */
+export function registerCompressor(toolNameOrPrefix, compressor) {
+    compressorRegistry.set(toolNameOrPrefix, compressor);
+}
+/**
+ * Clear all registered compressors.
+ */
+export function clearCompressors() {
+    compressorRegistry.clear();
+}
+// ─── Generic Compressor ─────────────────────────────────────────────
+/**
+ * Create a generic output compressor. Uses registered compressors for known tools,
+ * falls back to JSON-aware truncation.
+ */
+export function createOutputCompressor(options) {
+    const maxLength = options?.maxLength ?? DEFAULT_MAX_LENGTH;
+    const maxArrayItems = options?.maxArrayItems ?? DEFAULT_MAX_ARRAY_ITEMS;
+    const maxStringLength = options?.maxStringLength ?? DEFAULT_MAX_STRING_LENGTH;
+    return (toolName, output, overrideMax) => {
+        const limit = overrideMax ?? maxLength;
+        // Check registered compressors (exact match, then prefix match)
+        const exact = compressorRegistry.get(toolName);
+        if (exact)
+            return exact(output, limit);
+        for (const [prefix, compressor] of compressorRegistry) {
+            if (toolName.startsWith(prefix)) {
+                return compressor(output, limit);
+            }
+        }
+        // Already short enough
+        if (output.length <= limit)
+            return output;
+        // Try JSON-aware compression
+        try {
+            const parsed = JSON.parse(output);
+            const compressed = compressValue(parsed, maxArrayItems, maxStringLength);
+            const result = JSON.stringify(compressed, null, 2);
+            if (result.length <= limit)
+                return result;
+            return result.slice(0, limit) + '\n... (compressed, truncated)';
+        }
+        catch {
+            // Not JSON — plain text truncation
+            return output.slice(0, limit) + '\n... (truncated)';
+        }
+    };
+}
+// ─── JSON Compression ───────────────────────────────────────────────
+function compressValue(value, maxArrayItems, maxStringLength) {
+    if (value === null || value === undefined)
+        return value;
+    if (typeof value === 'string') {
+        if (value.length > maxStringLength) {
+            return value.slice(0, maxStringLength) + `... (+${value.length - maxStringLength} chars)`;
+        }
+        return value;
+    }
+    if (typeof value === 'number' || typeof value === 'boolean')
+        return value;
+    if (Array.isArray(value)) {
+        const truncated = value
+            .slice(0, maxArrayItems)
+            .map((item) => compressValue(item, maxArrayItems, maxStringLength));
+        if (value.length > maxArrayItems) {
+            truncated.push(`... +${value.length - maxArrayItems} more`);
+        }
+        return truncated;
+    }
+    if (typeof value === 'object') {
+        const obj = value;
+        const result = {};
+        for (const [key, val] of Object.entries(obj)) {
+            result[key] = compressValue(val, maxArrayItems, maxStringLength);
+        }
+        return result;
+    }
+    return value;
+}
+//# sourceMappingURL=output-compressor.js.map

package/dist/chat/output-compressor.js.map

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

package/dist/chat/queue.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Message Queue — disk-based message passing for zero-cost chat relay.
+ *
+ * The queue bot writes incoming messages to inbox/. Claude Code (or any
+ * processor) reads them, generates responses, and writes to outbox/.
+ * The outbox poller sends replies back through the chat transport.
+ *
+ * Directory structure:
+ *   ~/.{agentId}/queue/
+ *     inbox/    ← bot writes, processor reads
+ *     outbox/   ← processor writes, bot reads and sends
+ */
+export interface QueuedMessage {
+    /** Unique message ID: `{chatId}-{timestamp}`. */
+    id: string;
+    /** Chat/channel ID. */
+    chatId: string;
+    /** Sender user ID. */
+    userId: string;
+    /** Sender username (if available). */
+    username?: string;
+    /** Message type. */
+    type: 'text' | 'voice' | 'photo';
+    /** Text content (for text messages or transcribed voice). */
+    text?: string;
+    /** Voice metadata. */
+    voice?: {
+        fileId: string;
+        duration: number;
+    };
+    /** Photo metadata. */
+    photo?: {
+        fileId: string;
+        caption?: string;
+    };
+    /** ISO timestamp. */
+    timestamp: string;
+}
+export interface QueuedResponse {
+    /** Original message ID this responds to. */
+    messageId: string;
+    /** Target chat ID. */
+    chatId: string;
+    /** Response text. */
+    text: string;
+    /** ISO timestamp. */
+    timestamp: string;
+}
+export interface QueueConfig {
+    /** Base directory for queue (e.g., ~/.{agentId}/queue). */
+    queueDir: string;
+}
+export declare class MessageQueue {
+    private readonly inboxDir;
+    private readonly outboxDir;
+    constructor(config: QueueConfig);
+    /**
+     * Enqueue an incoming message to inbox.
+     */
+    enqueue(msg: Omit<QueuedMessage, 'id' | 'timestamp'>): QueuedMessage;
+    /**
+     * Read all pending inbox messages, sorted by timestamp.
+     */
+    readInbox(): QueuedMessage[];
+    /**
+     * Get the number of pending inbox messages.
+     */
+    inboxCount(): number;
+    /**
+     * Remove a message from inbox (after processing).
+     */
+    removeFromInbox(messageId: string): boolean;
+    /**
+     * Write a response to outbox.
+     */
+    sendResponse(messageId: string, chatId: string, text: string): QueuedResponse;
+    /**
+     * Read and remove all pending outbox responses.
+     */
+    drainOutbox(): QueuedResponse[];
+    /**
+     * Get outbox count.
+     */
+    outboxCount(): number;
+    /**
+     * Format inbox as readable text (for MCP tool output).
+     */
+    formatInbox(): string;
+    private listJsonFiles;
+}
+//# sourceMappingURL=queue.d.ts.map

package/dist/chat/queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../src/chat/queue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAcH,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,EAAE,EAAE,MAAM,CAAC;IACX,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oBAAoB;IACpB,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;IACjC,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,KAAK,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,sBAAsB;IACtB,KAAK,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAID,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,MAAM,EAAE,WAAW;IAO/B;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,GAAG,WAAW,CAAC,GAAG,aAAa;IASpE;;OAEG;IACH,SAAS,IAAI,aAAa,EAAE;IAkB5B;;OAEG;IACH,UAAU,IAAI,MAAM;IAIpB;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAY3C;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc;IAc7E;;OAEG;IACH,WAAW,IAAI,cAAc,EAAE;IAoB/B;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACH,WAAW,IAAI,MAAM;IAkBrB,OAAO,CAAC,aAAa;CAStB"}