learngraph 0.3.0 → 0.4.0

package/dist/cjs/llm/adapters/gemini.js

@@ -0,0 +1,156 @@
+"use strict";
+/**
+ * Google Gemini LLM adapter
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GeminiAdapter = void 0;
+exports.createGeminiAdapter = createGeminiAdapter;
+const base_js_1 = require("./base.js");
+/**
+ * Adapter for Google Gemini models
+ *
+ * Supports:
+ * - gemini-2.0-flash-exp
+ * - gemini-1.5-pro
+ * - gemini-1.5-flash
+ * - gemini-1.0-pro
+ */
+class GeminiAdapter extends base_js_1.BaseLLMAdapter {
+    baseUrl;
+    constructor(config) {
+        super(config);
+        // Use Google AI Studio API by default
+        this.baseUrl =
+            config.baseUrl ?? 'https://generativelanguage.googleapis.com/v1beta';
+    }
+    get provider() {
+        return 'gemini';
+    }
+    async complete(request) {
+        if (!this.isConfigured()) {
+            throw new base_js_1.LLMError('Gemini adapter is not configured. Set GOOGLE_API_KEY or GEMINI_API_KEY environment variable.', 'NOT_CONFIGURED', this.provider);
+        }
+        const geminiRequest = this.buildRequest(request);
+        try {
+            const response = await this.executeRequest(geminiRequest);
+            return this.parseResponse(response);
+        }
+        catch (error) {
+            if (error instanceof base_js_1.LLMError) {
+                throw error;
+            }
+            throw new base_js_1.LLMError(`Gemini API request failed: ${error instanceof Error ? error.message : 'Unknown error'}`, 'API_ERROR', this.provider, error instanceof Error ? error : undefined);
+        }
+    }
+    buildRequest(request) {
+        const geminiRequest = {
+            contents: [],
+            generationConfig: {
+                maxOutputTokens: request.maxTokens ?? this.config.maxTokens ?? 4096,
+                temperature: request.temperature ?? this.config.temperature ?? 0.3,
+            },
+        };
+        // Handle JSON response format
+        if (request.responseFormat === 'json') {
+            geminiRequest.generationConfig.responseMimeType = 'application/json';
+        }
+        // Convert messages to Gemini format
+        for (const message of request.messages) {
+            if (message.role === 'system') {
+                // Gemini uses systemInstruction for system messages
+                geminiRequest.systemInstruction = {
+                    parts: [{ text: message.content }],
+                };
+            }
+            else {
+                geminiRequest.contents.push({
+                    role: message.role === 'assistant' ? 'model' : 'user',
+                    parts: [{ text: message.content }],
+                });
+            }
+        }
+        return geminiRequest;
+    }
+    async executeRequest(request) {
+        const url = `${this.baseUrl}/models/${this.config.model}:generateContent?key=${this.config.apiKey}`;
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify(request),
+            signal: AbortSignal.timeout(this.config.timeout ?? 60000),
+        });
+        if (!response.ok) {
+            const errorBody = await response.text();
+            let errorMessage = `HTTP ${response.status}`;
+            try {
+                const errorJson = JSON.parse(errorBody);
+                errorMessage = errorJson.error?.message ?? errorMessage;
+            }
+            catch {
+                errorMessage = errorBody || errorMessage;
+            }
+            if (response.status === 429) {
+                throw new base_js_1.LLMError(`Rate limit exceeded: ${errorMessage}`, 'RATE_LIMIT', this.provider);
+            }
+            throw new base_js_1.LLMError(`Gemini API error: ${errorMessage}`, 'API_ERROR', this.provider);
+        }
+        return response.json();
+    }
+    parseResponse(response) {
+        if (!response.candidates || response.candidates.length === 0) {
+            throw new base_js_1.LLMError('No candidates in Gemini response', 'INVALID_RESPONSE', this.provider);
+        }
+        const candidate = response.candidates[0];
+        if (!candidate) {
+            throw new base_js_1.LLMError('No candidate in Gemini response', 'INVALID_RESPONSE', this.provider);
+        }
+        const content = candidate.content.parts.map((p) => p.text).join('');
+        // Try to parse JSON if present
+        let json;
+        try {
+            json = this.parseJSON(content);
+        }
+        catch {
+            // Not JSON, that's fine
+        }
+        // Map Gemini finish reasons to our standard format
+        const finishReason = candidate.finishReason === 'STOP' ? 'stop' :
+            candidate.finishReason === 'MAX_TOKENS' ? 'length' :
+                candidate.finishReason === 'SAFETY' ? 'content_filter' : 'stop';
+        return {
+            content,
+            json,
+            usage: {
+                promptTokens: response.usageMetadata?.promptTokenCount ?? 0,
+                completionTokens: response.usageMetadata?.candidatesTokenCount ?? 0,
+                totalTokens: response.usageMetadata?.totalTokenCount ?? 0,
+            },
+            model: this.config.model,
+            finishReason,
+        };
+    }
+}
+exports.GeminiAdapter = GeminiAdapter;
+/**
+ * Create a Gemini adapter from environment variables
+ */
+function createGeminiAdapter(model = 'gemini-2.0-flash-exp', overrides) {
+    // Support both GOOGLE_API_KEY and GEMINI_API_KEY
+    const apiKey = typeof process !== 'undefined'
+        ? process.env.GOOGLE_API_KEY ?? process.env.GEMINI_API_KEY
+        : undefined;
+    const config = {
+        provider: 'gemini',
+        model,
+        ...overrides,
+    };
+    if (apiKey) {
+        config.apiKey = apiKey;
+    }
+    return new GeminiAdapter(config);
+}
+//# sourceMappingURL=gemini.js.map

package/dist/cjs/llm/adapters/gemini.js.map

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

package/dist/cjs/llm/adapters/index.js

@@ -5,7 +5,7 @@
  * @packageDocumentation
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createOllamaAdapter = exports.OllamaAdapter = exports.createAnthropicAdapter = exports.AnthropicAdapter = exports.createOpenAIAdapter = exports.OpenAIAdapter = exports.DEFAULT_CONFIG = exports.LLMError = exports.BaseLLMAdapter = void 0;
+exports.MEDIAPIPE_MODELS = exports.createMediaPipeAdapter = exports.MediaPipeAdapter = exports.OPENROUTER_MODELS = exports.createOpenRouterAdapter = exports.OpenRouterAdapter = exports.createGeminiAdapter = exports.GeminiAdapter = exports.createOllamaAdapter = exports.OllamaAdapter = exports.createAnthropicAdapter = exports.AnthropicAdapter = exports.createOpenAIAdapter = exports.OpenAIAdapter = exports.DEFAULT_CONFIG = exports.LLMError = exports.BaseLLMAdapter = void 0;
 var base_js_1 = require("./base.js");
 Object.defineProperty(exports, "BaseLLMAdapter", { enumerable: true, get: function () { return base_js_1.BaseLLMAdapter; } });
 Object.defineProperty(exports, "LLMError", { enumerable: true, get: function () { return base_js_1.LLMError; } });
@@ -19,4 +19,15 @@ Object.defineProperty(exports, "createAnthropicAdapter", { enumerable: true, get
 var ollama_js_1 = require("./ollama.js");
 Object.defineProperty(exports, "OllamaAdapter", { enumerable: true, get: function () { return ollama_js_1.OllamaAdapter; } });
 Object.defineProperty(exports, "createOllamaAdapter", { enumerable: true, get: function () { return ollama_js_1.createOllamaAdapter; } });
+var gemini_js_1 = require("./gemini.js");
+Object.defineProperty(exports, "GeminiAdapter", { enumerable: true, get: function () { return gemini_js_1.GeminiAdapter; } });
+Object.defineProperty(exports, "createGeminiAdapter", { enumerable: true, get: function () { return gemini_js_1.createGeminiAdapter; } });
+var openrouter_js_1 = require("./openrouter.js");
+Object.defineProperty(exports, "OpenRouterAdapter", { enumerable: true, get: function () { return openrouter_js_1.OpenRouterAdapter; } });
+Object.defineProperty(exports, "createOpenRouterAdapter", { enumerable: true, get: function () { return openrouter_js_1.createOpenRouterAdapter; } });
+Object.defineProperty(exports, "OPENROUTER_MODELS", { enumerable: true, get: function () { return openrouter_js_1.OPENROUTER_MODELS; } });
+var mediapipe_js_1 = require("./mediapipe.js");
+Object.defineProperty(exports, "MediaPipeAdapter", { enumerable: true, get: function () { return mediapipe_js_1.MediaPipeAdapter; } });
+Object.defineProperty(exports, "createMediaPipeAdapter", { enumerable: true, get: function () { return mediapipe_js_1.createMediaPipeAdapter; } });
+Object.defineProperty(exports, "MEDIAPIPE_MODELS", { enumerable: true, get: function () { return mediapipe_js_1.MEDIAPIPE_MODELS; } });
 //# sourceMappingURL=index.js.map

package/dist/cjs/llm/adapters/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/llm/adapters/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,qCAAqE;AAA5D,yGAAA,cAAc,OAAA;AAAE,mGAAA,QAAQ,OAAA;AAAE,yGAAA,cAAc,OAAA;AAGjD,yCAAiE;AAAxD,0GAAA,aAAa,OAAA;AAAE,gHAAA,mBAAmB,OAAA;AAC3C,+CAA0E;AAAjE,gHAAA,gBAAgB,OAAA;AAAE,sHAAA,sBAAsB,OAAA;AACjD,yCAAiE;AAAxD,0GAAA,aAAa,OAAA;AAAE,gHAAA,mBAAmB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/llm/adapters/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,qCAAqE;AAA5D,yGAAA,cAAc,OAAA;AAAE,mGAAA,QAAQ,OAAA;AAAE,yGAAA,cAAc,OAAA;AAGjD,yCAAiE;AAAxD,0GAAA,aAAa,OAAA;AAAE,gHAAA,mBAAmB,OAAA;AAC3C,+CAA0E;AAAjE,gHAAA,gBAAgB,OAAA;AAAE,sHAAA,sBAAsB,OAAA;AACjD,yCAAiE;AAAxD,0GAAA,aAAa,OAAA;AAAE,gHAAA,mBAAmB,OAAA;AAC3C,yCAAiE;AAAxD,0GAAA,aAAa,OAAA;AAAE,gHAAA,mBAAmB,OAAA;AAC3C,iDAAgG;AAAvF,kHAAA,iBAAiB,OAAA;AAAE,wHAAA,uBAAuB,OAAA;AAAE,kHAAA,iBAAiB,OAAA;AACtE,+CAA4F;AAAnF,gHAAA,gBAAgB,OAAA;AAAE,sHAAA,sBAAsB,OAAA;AAAE,gHAAA,gBAAgB,OAAA"}

package/dist/cjs/llm/adapters/mediapipe.js

@@ -0,0 +1,290 @@
+"use strict";
+/**
+ * MediaPipe LLM Inference adapter for local Gemma models
+ *
+ * This adapter integrates with Google's MediaPipe LLM Inference Task API
+ * to run Gemma models locally using WebGPU acceleration.
+ *
+ * Supported models:
+ * - Gemma 2B / 7B
+ * - Gemma 2 2B
+ * - Gemma 3n (2B, 4B parameters)
+ *
+ * Requirements:
+ * - WebGPU-capable browser or Node.js with WebGPU support
+ * - @mediapipe/tasks-genai package
+ * - Downloaded model weights (.bin file)
+ *
+ * @packageDocumentation
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MediaPipeAdapter = exports.MEDIAPIPE_MODELS = void 0;
+exports.createMediaPipeAdapter = createMediaPipeAdapter;
+const base_js_1 = require("./base.js");
+/**
+ * Gemma model variants for MediaPipe
+ */
+exports.MEDIAPIPE_MODELS = {
+    'gemma-2b': 'gemma-2b-it-gpu-int4.bin',
+    'gemma-7b': 'gemma-7b-it-gpu-int8.bin',
+    'gemma2-2b': 'gemma2-2b-it-gpu-int4.bin',
+    'gemma3n-e2b': 'gemma-3n-E2B-it-int4.task',
+    'gemma3n-e4b': 'gemma-3n-E4B-it-int4.task',
+};
+/**
+ * Adapter for MediaPipe LLM Inference API
+ *
+ * Runs Gemma models locally using WebGPU acceleration.
+ * The adapter lazily loads the model on first use.
+ *
+ * @example
+ * ```typescript
+ * import { MediaPipeAdapter } from 'learngraph/llm';
+ *
+ * const adapter = new MediaPipeAdapter({
+ *   provider: 'mediapipe',
+ *   model: 'gemma3n-e2b',
+ *   modelPath: '/models/gemma-3n-E2B-it-int4.task',
+ * });
+ *
+ * // Use with orchestrator
+ * const orchestrator = createOrchestrator(adapter);
+ * ```
+ */
+class MediaPipeAdapter extends base_js_1.BaseLLMAdapter {
+    inference = null;
+    modelPath;
+    randomSeed;
+    topK;
+    loraRanks;
+    initPromise = null;
+    constructor(config) {
+        super(config);
+        this.modelPath = config.modelPath;
+        this.topK = config.topK ?? 40;
+        if (config.randomSeed !== undefined) {
+            this.randomSeed = config.randomSeed;
+        }
+        if (config.loraRanks !== undefined) {
+            this.loraRanks = config.loraRanks;
+        }
+    }
+    get provider() {
+        return 'mediapipe';
+    }
+    /**
+     * Check if MediaPipe is configured (model path exists)
+     */
+    isConfigured() {
+        return !!this.modelPath;
+    }
+    /**
+     * Initialize the MediaPipe LLM Inference engine
+     * Called automatically on first request
+     */
+    async initialize() {
+        if (this.inference) {
+            return;
+        }
+        // Prevent multiple simultaneous initializations
+        if (this.initPromise) {
+            return this.initPromise;
+        }
+        this.initPromise = this.doInitialize();
+        await this.initPromise;
+    }
+    async doInitialize() {
+        try {
+            // Dynamic import of MediaPipe
+            // Users must install @mediapipe/tasks-genai separately
+            const mediapipe = await this.loadMediaPipe();
+            const maxTokens = this.config.maxTokens ?? 1024;
+            const temperature = this.config.temperature ?? 0.3;
+            const options = {
+                baseOptions: {
+                    modelAssetPath: this.modelPath,
+                },
+                maxTokens,
+                temperature,
+                topK: this.topK,
+            };
+            if (this.randomSeed !== undefined) {
+                options.randomSeed = this.randomSeed;
+            }
+            if (this.loraRanks !== undefined) {
+                options.loraRanks = this.loraRanks;
+            }
+            this.inference = await mediapipe.LlmInference.createFromOptions(options);
+        }
+        catch (error) {
+            this.initPromise = null;
+            throw new base_js_1.LLMError(`Failed to initialize MediaPipe: ${error instanceof Error ? error.message : 'Unknown error'}. ` +
+                'Make sure @mediapipe/tasks-genai is installed and the model file exists.', 'NOT_CONFIGURED', this.provider, error instanceof Error ? error : undefined);
+        }
+    }
+    /**
+     * Load MediaPipe library dynamically
+     */
+    async loadMediaPipe() {
+        try {
+            // Try to import the MediaPipe package dynamically
+            // @ts-expect-error - Dynamic import of optional dependency
+            const module = await Promise.resolve().then(() => __importStar(require('@mediapipe/tasks-genai')));
+            return module;
+        }
+        catch {
+            throw new Error('MediaPipe tasks-genai not found. Install it with: npm install @mediapipe/tasks-genai');
+        }
+    }
+    async complete(request) {
+        if (!this.isConfigured()) {
+            throw new base_js_1.LLMError('MediaPipe adapter is not configured. Provide modelPath in config.', 'NOT_CONFIGURED', this.provider);
+        }
+        // Initialize on first use
+        await this.initialize();
+        if (!this.inference) {
+            throw new base_js_1.LLMError('MediaPipe inference engine not initialized', 'NOT_CONFIGURED', this.provider);
+        }
+        // Build prompt from messages
+        const prompt = this.buildPrompt(request);
+        try {
+            const response = await this.inference.generateResponse(prompt);
+            return this.parseGeneratedResponse(response, prompt);
+        }
+        catch (error) {
+            throw new base_js_1.LLMError(`MediaPipe generation failed: ${error instanceof Error ? error.message : 'Unknown error'}`, 'API_ERROR', this.provider, error instanceof Error ? error : undefined);
+        }
+    }
+    /**
+     * Build a prompt string from chat messages
+     * Uses Gemma's instruction format
+     */
+    buildPrompt(request) {
+        const parts = [];
+        for (const message of request.messages) {
+            switch (message.role) {
+                case 'system':
+                    // Gemma uses <start_of_turn> format
+                    parts.push(`<start_of_turn>user\n${message.content}<end_of_turn>`);
+                    break;
+                case 'user':
+                    parts.push(`<start_of_turn>user\n${message.content}<end_of_turn>`);
+                    break;
+                case 'assistant':
+                    parts.push(`<start_of_turn>model\n${message.content}<end_of_turn>`);
+                    break;
+            }
+        }
+        // Add model turn prefix
+        parts.push('<start_of_turn>model\n');
+        // Add JSON format instruction if requested
+        if (request.responseFormat === 'json') {
+            return parts.join('\n') + '\nRespond with valid JSON only:\n';
+        }
+        return parts.join('\n');
+    }
+    /**
+     * Parse the generated response
+     */
+    parseGeneratedResponse(response, prompt) {
+        // Estimate tokens (rough approximation: ~4 chars per token)
+        const promptTokens = Math.ceil(prompt.length / 4);
+        const completionTokens = Math.ceil(response.length / 4);
+        // Try to parse JSON if present
+        let json;
+        try {
+            json = this.parseJSON(response);
+        }
+        catch {
+            // Not JSON, that's fine
+        }
+        return {
+            content: response,
+            json,
+            usage: {
+                promptTokens,
+                completionTokens,
+                totalTokens: promptTokens + completionTokens,
+            },
+            model: this.config.model,
+            finishReason: 'stop', // MediaPipe doesn't provide finish reason, assume stop
+        };
+    }
+    /**
+     * Close the inference engine and release resources
+     */
+    close() {
+        if (this.inference) {
+            this.inference.close();
+            this.inference = null;
+            this.initPromise = null;
+        }
+    }
+}
+exports.MediaPipeAdapter = MediaPipeAdapter;
+/**
+ * Create a MediaPipe adapter for local Gemma models
+ *
+ * @param modelPath - Path to the model file (.bin or .task)
+ * @param model - Model identifier (for reference)
+ * @param overrides - Additional configuration options
+ *
+ * @example
+ * ```typescript
+ * // Using a Gemma 3n model
+ * const adapter = createMediaPipeAdapter(
+ *   '/models/gemma-3n-E2B-it-int4.task',
+ *   'gemma3n-e2b'
+ * );
+ *
+ * // With custom options
+ * const adapter = createMediaPipeAdapter(
+ *   '/models/gemma2-2b-it-gpu-int4.bin',
+ *   'gemma2-2b',
+ *   { maxTokens: 2048, temperature: 0.5 }
+ * );
+ * ```
+ */
+function createMediaPipeAdapter(modelPath, model = 'gemma3n', overrides) {
+    const config = {
+        provider: 'mediapipe',
+        model,
+        modelPath,
+        ...overrides,
+    };
+    return new MediaPipeAdapter(config);
+}
+//# sourceMappingURL=mediapipe.js.map

package/dist/cjs/llm/adapters/mediapipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mediapipe.js","sourceRoot":"","sources":["../../../../src/llm/adapters/mediapipe.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4TH,wDAaC;AAjUD,uCAAqD;AAoCrD;;GAEG;AACU,QAAA,gBAAgB,GAAG;IAC9B,UAAU,EAAE,0BAA0B;IACtC,UAAU,EAAE,0BAA0B;IACtC,WAAW,EAAE,2BAA2B;IACxC,aAAa,EAAE,2BAA2B;IAC1C,aAAa,EAAE,2BAA2B;CAClC,CAAC;AAEX;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAa,gBAAiB,SAAQ,wBAAc;IAC1C,SAAS,GAAwB,IAAI,CAAC;IAC7B,SAAS,CAAS;IAClB,UAAU,CAAU;IACpB,IAAI,CAAS;IACb,SAAS,CAAU;IAC5B,WAAW,GAAyB,IAAI,CAAC;IAEjD,YAAY,MAAuB;QACjC,KAAK,CAAC,MAAM,CAAC,CAAC;QACd,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QAC9B,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YACpC,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;QACtC,CAAC;QACD,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YACnC,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QACpC,CAAC;IACH,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,WAAW,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,YAAY;QACV,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,UAAU;QACd,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,OAAO;QACT,CAAC;QAED,gDAAgD;QAChD,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,OAAO,IAAI,CAAC,WAAW,CAAC;QAC1B,CAAC;QAED,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QACvC,MAAM,IAAI,CAAC,WAAW,CAAC;IACzB,CAAC;IAEO,KAAK,CAAC,YAAY;QACxB,IAAI,CAAC;YACH,8BAA8B;YAC9B,uDAAuD;YACvD,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;YAE7C,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC;YAChD,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,GAAG,CAAC;YAEnD,MAAM,OAAO,GAAwB;gBACnC,WAAW,EAAE;oBACX,cAAc,EAAE,IAAI,CAAC,SAAS;iBAC/B;gBACD,SAAS;gBACT,WAAW;gBACX,IAAI,EAAE,IAAI,CAAC,IAAI;aAChB,CAAC;YAEF,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;gBAClC,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;YACvC,CAAC;YAED,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;gBACjC,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;YACrC,CAAC;YAED,IAAI,CAAC,SAAS,GAAG,MAAM,SAAS,CAAC,YAAY,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAC3E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;YACxB,MAAM,IAAI,kBAAQ,CAChB,mCAAmC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,IAAI;gBAC7F,0EAA0E,EAC5E,gBAAgB,EAChB,IAAI,CAAC,QAAQ,EACb,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAC3C,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,aAAa;QACzB,IAAI,CAAC;YACH,kDAAkD;YAClD,2DAA2D;YAC3D,MAAM,MAAM,GAAG,wDAAa,wBAAwB,GAAC,CAAC;YACtD,OAAO,MAAmD,CAAC;QAC7D,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CACb,sFAAsF,CACvF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,OAA0B;QACvC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC;YACzB,MAAM,IAAI,kBAAQ,CAChB,mEAAmE,EACnE,gBAAgB,EAChB,IAAI,CAAC,QAAQ,CACd,CAAC;QACJ,CAAC;QAED,0BAA0B;QAC1B,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QAExB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,IAAI,kBAAQ,CAChB,4CAA4C,EAC5C,gBAAgB,EAChB,IAAI,CAAC,QAAQ,CACd,CAAC;QACJ,CAAC;QAED,6BAA6B;QAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAEzC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;YAE/D,OAAO,IAAI,CAAC,sBAAsB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACvD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,kBAAQ,CAChB,gCAAgC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,EAC1F,WAAW,EACX,IAAI,CAAC,QAAQ,EACb,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAC3C,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,WAAW,CAAC,OAA0B;QAC5C,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACvC,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;gBACrB,KAAK,QAAQ;oBACX,oCAAoC;oBACpC,KAAK,CAAC,IAAI,CAAC,wBAAwB,OAAO,CAAC,OAAO,eAAe,CAAC,CAAC;oBACnE,MAAM;gBACR,KAAK,MAAM;oBACT,KAAK,CAAC,IAAI,CAAC,wBAAwB,OAAO,CAAC,OAAO,eAAe,CAAC,CAAC;oBACnE,MAAM;gBACR,KAAK,WAAW;oBACd,KAAK,CAAC,IAAI,CAAC,yBAAyB,OAAO,CAAC,OAAO,eAAe,CAAC,CAAC;oBACpE,MAAM;YACV,CAAC;QACH,CAAC;QAED,wBAAwB;QACxB,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QAErC,2CAA2C;QAC3C,IAAI,OAAO,CAAC,cAAc,KAAK,MAAM,EAAE,CAAC;YACtC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,mCAAmC,CAAC;QAChE,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACK,sBAAsB,CAC5B,QAAgB,EAChB,MAAc;QAEd,4DAA4D;QAC5D,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAClD,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAExD,+BAA+B;QAC/B,IAAI,IAAyC,CAAC;QAC9C,IAAI,CAAC;YACH,IAAI,GAAG,IAAI,CAAC,SAAS,CAA0B,QAAQ,CAAC,CAAC;QAC3D,CAAC;QAAC,MAAM,CAAC;YACP,wBAAwB;QAC1B,CAAC;QAED,OAAO;YACL,OAAO,EAAE,QAAQ;YACjB,IAAI;YACJ,KAAK,EAAE;gBACL,YAAY;gBACZ,gBAAgB;gBAChB,WAAW,EAAE,YAAY,GAAG,gBAAgB;aAC7C;YACD,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;YACxB,YAAY,EAAE,MAAM,EAAE,uDAAuD;SAC9E,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;YACvB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;YACtB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QAC1B,CAAC;IACH,CAAC;CACF;AAxND,4CAwNC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,SAAgB,sBAAsB,CACpC,SAAiB,EACjB,KAAK,GAAG,SAAS,EACjB,SAAoE;IAEpE,MAAM,MAAM,GAAoB;QAC9B,QAAQ,EAAE,WAAW;QACrB,KAAK;QACL,SAAS;QACT,GAAG,SAAS;KACb,CAAC;IAEF,OAAO,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;AACtC,CAAC"}