@animus-labs/cortex 0.2.0

package/dist/tools/web-fetch/index.js

@@ -0,0 +1,513 @@
+/**
+ * WebFetch tool: fetch a web page and return its content as processed text.
+ *
+ * Two-model architecture:
+ * 1. Fetch: HTTP request via Node built-in fetch
+ * 2. Convert: HTML to markdown via Turndown
+ * 3. Summarize: utility model answers the prompt using the page content
+ *
+ * The main agent never sees raw page content.
+ *
+ * Reference: docs/cortex/tools/web-fetch.md
+ */
+import { promises as dns } from 'node:dns';
+import { isIPv4, isIPv6 } from 'node:net';
+import { Type } from 'typebox';
+import { WebFetchCache } from './cache.js';
+import { attachRuntimeAwareTool } from '../runtime.js';
+// ---------------------------------------------------------------------------
+// Schema
+// ---------------------------------------------------------------------------
+export const WebFetchParams = Type.Object({
+    url: Type.String({ description: 'The URL to fetch. HTTP auto-upgraded to HTTPS.' }),
+    prompt: Type.String({ description: 'A question or instruction about what to extract from the page.' }),
+});
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const REQUEST_TIMEOUT = 30_000;
+const DEFAULT_MAX_PER_LOOP = 300;
+const USER_AGENT = 'Cortex/1.0 (web-fetch tool)';
+/**
+ * Maximum tokens of page content sent to the utility model for summarization.
+ *
+ * Distinct from the agent-side result-persistence interceptor: this cap is
+ * about cost/latency on the summarization step, not main-agent context. We
+ * pick a value generous enough to let the utility model see most of a page
+ * (utility models typically have 200K+ context windows) while preventing
+ * pathological cases where a 1MB page burns excessive tokens on every fetch.
+ */
+const MAX_UTILITY_MODEL_INPUT_TOKENS = 100_000;
+/**
+ * Hostname strings that always resolve to private/local addresses.
+ * Checked before DNS resolution as a fast-path reject.
+ *
+ * Note: this list is a fast-path optimization, not the security boundary.
+ * The actual SSRF protection comes from validateResolvedIp(), which checks
+ * the DNS-resolved IP against private ranges before every fetch. A TOCTOU
+ * window exists between our DNS check and Node's internal fetch DNS lookup;
+ * mitigating DNS rebinding fully would require socket-level interception.
+ */
+const PRIVATE_HOSTNAME_PATTERNS = [
+    /^localhost$/i,
+    /^0\.0\.0\.0$/,
+    /^127\.\d+\.\d+\.\d+$/,
+    /^\[?::1\]?$/,
+];
+/**
+ * Check whether an IP address (v4 or v6) belongs to a private, loopback,
+ * link-local, or otherwise non-routable range. Handles IPv4-mapped IPv6
+ * addresses (::ffff:x.x.x.x) and parses octets numerically to catch
+ * alternate encodings (decimal IPs, zero-padded, etc.).
+ */
+export function isPrivateIp(ip) {
+    let normalized = ip;
+    // Normalize IPv4-mapped IPv6 (::ffff:127.0.0.1 -> 127.0.0.1)
+    if (normalized.toLowerCase().startsWith('::ffff:')) {
+        normalized = normalized.slice(7);
+    }
+    if (isIPv4(normalized)) {
+        const octets = normalized.split('.').map(Number);
+        if (octets.length !== 4 || octets.some(o => isNaN(o) || o < 0 || o > 255)) {
+            // Malformed, treat as private (fail-safe)
+            return true;
+        }
+        // 127.0.0.0/8 (loopback)
+        if (octets[0] === 127)
+            return true;
+        // 10.0.0.0/8
+        if (octets[0] === 10)
+            return true;
+        // 172.16.0.0/12
+        if (octets[0] === 172 && octets[1] >= 16 && octets[1] <= 31)
+            return true;
+        // 192.168.0.0/16
+        if (octets[0] === 192 && octets[1] === 168)
+            return true;
+        // 169.254.0.0/16 (link-local, cloud metadata)
+        if (octets[0] === 169 && octets[1] === 254)
+            return true;
+        // 0.0.0.0/8
+        if (octets[0] === 0)
+            return true;
+        return false;
+    }
+    if (isIPv6(ip)) {
+        const lower = ip.toLowerCase();
+        // ::1 (loopback)
+        if (lower === '::1' || lower === '0:0:0:0:0:0:0:1')
+            return true;
+        // fe80::/10 (link-local)
+        if (lower.startsWith('fe80:'))
+            return true;
+        // fc00::/7 (unique local, includes fd00::/8)
+        const firstSegment = lower.split(':')[0] ?? '';
+        const firstVal = parseInt(firstSegment, 16);
+        if (!isNaN(firstVal) && (firstVal & 0xfe00) === 0xfc00)
+            return true;
+        // :: (unspecified)
+        if (lower === '::' || lower === '0:0:0:0:0:0:0:0')
+            return true;
+        return false;
+    }
+    // Unrecognized format, fail-safe: treat as private
+    return true;
+}
+/**
+ * Resolve a hostname via DNS and validate that the resolved IP is not private.
+ * Throws if the hostname resolves to a private/loopback/link-local address.
+ */
+async function validateResolvedIp(hostname) {
+    // If the hostname is already a literal IP, validate directly
+    if (isIPv4(hostname) || isIPv6(hostname)) {
+        if (isPrivateIp(hostname)) {
+            throw new Error(`URL resolves to private IP ${hostname}`);
+        }
+        return;
+    }
+    const { address } = await dns.lookup(hostname);
+    if (isPrivateIp(address)) {
+        throw new Error(`URL resolves to private IP ${address}`);
+    }
+}
+let turndownServicePromise;
+function getTurndownService() {
+    return (turndownServicePromise ??= import('turndown').then(m => {
+        const Turndown = m.default;
+        return new Turndown({
+            headingStyle: 'atx',
+            codeBlockStyle: 'fenced',
+            bulletListMarker: '-',
+        });
+    }));
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Validate a URL, rejecting dangerous schemes, private hostnames, and literal private IPs.
+ * This is the first-pass check (hostname/literal IP only). DNS resolution is done
+ * separately before each fetch to catch DNS rebinding attacks.
+ */
+function validateUrl(urlStr) {
+    let url;
+    try {
+        url = new URL(urlStr);
+    }
+    catch {
+        return { valid: false, reason: 'Invalid URL format' };
+    }
+    // Reject non-HTTP(S) schemes
+    if (url.protocol !== 'http:' && url.protocol !== 'https:') {
+        return { valid: false, reason: `URL scheme "${url.protocol}" is not allowed. Only http: and https: are supported.` };
+    }
+    // Auto-upgrade HTTP to HTTPS
+    if (url.protocol === 'http:') {
+        url = new URL(urlStr.replace(/^http:/, 'https:'));
+    }
+    const hostname = url.hostname;
+    // Check hostname-level blocklist (localhost, etc.)
+    for (const pattern of PRIVATE_HOSTNAME_PATTERNS) {
+        if (pattern.test(hostname)) {
+            return { valid: false, reason: `URL rejected: private/local network address (${hostname})` };
+        }
+    }
+    // If the hostname is a literal IP, validate it structurally
+    if (isIPv4(hostname) || isIPv6(hostname)) {
+        if (isPrivateIp(hostname)) {
+            return { valid: false, reason: `URL rejected: private/local network address (${hostname})` };
+        }
+    }
+    return { valid: true, url };
+}
+/**
+ * Strip HTML elements that are not useful for content extraction.
+ * This is a simple regex-based approach for removing script, style,
+ * nav, footer, and header elements before Turndown conversion.
+ */
+function stripBoilerplateHtml(html) {
+    // Remove script, style, nav, footer, header, aside, noscript
+    const tagsToRemove = ['script', 'style', 'nav', 'footer', 'header', 'aside', 'noscript', 'svg'];
+    let cleaned = html;
+    for (const tag of tagsToRemove) {
+        const regex = new RegExp(`<${tag}[^>]*>[\\s\\S]*?</${tag}>`, 'gi');
+        cleaned = cleaned.replace(regex, '');
+        // Also remove self-closing variants
+        cleaned = cleaned.replace(new RegExp(`<${tag}[^>]*/>`, 'gi'), '');
+    }
+    return cleaned;
+}
+// ---------------------------------------------------------------------------
+// Tool factory
+// ---------------------------------------------------------------------------
+export function createWebFetchTool(config) {
+    const runtimeWebFetch = config.runtime?.webFetch;
+    const cache = runtimeWebFetch?.getCache() ?? new WebFetchCache();
+    const maxPerLoop = config.maxPerLoop ?? DEFAULT_MAX_PER_LOOP;
+    let fetchesThisLoop = 0;
+    const tool = {
+        name: 'WebFetch',
+        description: 'Fetch a web page and return a summarized answer to your question about its content.',
+        parameters: WebFetchParams,
+        resetRateLimit() {
+            if (runtimeWebFetch) {
+                runtimeWebFetch.resetLoop();
+                return;
+            }
+            fetchesThisLoop = 0;
+        },
+        getCache() {
+            return cache;
+        },
+        async execute(params) {
+            // URL validation
+            const validation = validateUrl(params.url);
+            if (!validation.valid) {
+                return {
+                    content: [{ type: 'text', text: `URL rejected: ${validation.reason}` }],
+                    details: {
+                        finalUrl: params.url,
+                        statusCode: 0,
+                        cacheHit: false,
+                        rawSize: 0,
+                        markdownSize: 0,
+                    },
+                };
+            }
+            const url = validation.url;
+            const urlStr = url.toString();
+            // Check cache (cached responses don't count against rate limit)
+            const cached = cache.get(urlStr);
+            if (cached) {
+                // Still need to summarize with the user's prompt
+                const summary = await summarize(cached.content, params.prompt, config.utilityComplete);
+                return {
+                    content: [{ type: 'text', text: summary }],
+                    details: {
+                        finalUrl: cached.finalUrl,
+                        statusCode: cached.statusCode,
+                        cacheHit: true,
+                        rawSize: 0,
+                        markdownSize: cached.content.length,
+                    },
+                };
+            }
+            // Rate limit check (only for non-cached fetches)
+            const currentFetchCount = runtimeWebFetch?.fetchCount ?? fetchesThisLoop;
+            if (currentFetchCount >= maxPerLoop) {
+                return {
+                    content: [{ type: 'text', text: `WebFetch rate limit reached (${maxPerLoop} per loop). Wait for the next loop or use Bash with curl for direct access.` }],
+                    details: {
+                        finalUrl: urlStr,
+                        statusCode: 0,
+                        cacheHit: false,
+                        rawSize: 0,
+                        markdownSize: 0,
+                    },
+                };
+            }
+            if (runtimeWebFetch) {
+                runtimeWebFetch.incrementFetchCount();
+            }
+            else {
+                fetchesThisLoop++;
+            }
+            // DNS pre-resolution: resolve hostname and validate the IP is not private.
+            // This prevents DNS rebinding attacks where a domain initially resolves to
+            // a public IP during validation but resolves to 127.0.0.1 at fetch time.
+            try {
+                await validateResolvedIp(url.hostname);
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                return {
+                    content: [{ type: 'text', text: `URL rejected: ${msg}` }],
+                    details: {
+                        finalUrl: urlStr,
+                        statusCode: 0,
+                        cacheHit: false,
+                        rawSize: 0,
+                        markdownSize: 0,
+                    },
+                };
+            }
+            // Fetch the URL (manual redirect to detect cross-host redirects)
+            let response;
+            let currentUrl = urlStr;
+            const maxRedirects = 10;
+            let redirectCount = 0;
+            // eslint-disable-next-line no-constant-condition
+            while (true) {
+                try {
+                    const controller = new AbortController();
+                    const timeoutId = setTimeout(() => controller.abort(), REQUEST_TIMEOUT);
+                    response = await fetch(currentUrl, {
+                        signal: controller.signal,
+                        headers: {
+                            'User-Agent': USER_AGENT,
+                            'Accept': 'text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8',
+                        },
+                        redirect: 'manual',
+                    });
+                    clearTimeout(timeoutId);
+                }
+                catch (err) {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    if (msg.includes('abort')) {
+                        return {
+                            content: [{ type: 'text', text: `Request timed out: ${currentUrl}` }],
+                            details: { finalUrl: currentUrl, statusCode: 0, cacheHit: false, rawSize: 0, markdownSize: 0 },
+                        };
+                    }
+                    if (msg.includes('ENOTFOUND') || msg.includes('getaddrinfo')) {
+                        const hostname = url.hostname;
+                        return {
+                            content: [{ type: 'text', text: `Could not resolve host: ${hostname}` }],
+                            details: { finalUrl: currentUrl, statusCode: 0, cacheHit: false, rawSize: 0, markdownSize: 0 },
+                        };
+                    }
+                    if (msg.includes('certificate') || msg.includes('SSL') || msg.includes('TLS')) {
+                        return {
+                            content: [{ type: 'text', text: `SSL certificate error for ${currentUrl}` }],
+                            details: { finalUrl: currentUrl, statusCode: 0, cacheHit: false, rawSize: 0, markdownSize: 0 },
+                        };
+                    }
+                    return {
+                        content: [{ type: 'text', text: `Failed to fetch ${currentUrl}: ${msg}` }],
+                        details: { finalUrl: currentUrl, statusCode: 0, cacheHit: false, rawSize: 0, markdownSize: 0 },
+                    };
+                }
+                // Handle redirects (3xx status)
+                const status = response.status;
+                if (status >= 300 && status < 400) {
+                    const location = response.headers.get('location');
+                    if (!location)
+                        break; // No Location header, treat as final response
+                    // Resolve relative redirect URLs
+                    const redirectUrl = new URL(location, currentUrl).toString();
+                    const currentHost = new URL(currentUrl).hostname;
+                    const redirectHost = new URL(redirectUrl).hostname;
+                    // Cross-host redirect: inform the model instead of following
+                    if (redirectHost !== currentHost) {
+                        return {
+                            content: [{ type: 'text', text: `This URL redirects to ${redirectUrl}. Make a new WebFetch request with this URL.` }],
+                            details: {
+                                finalUrl: redirectUrl,
+                                statusCode: status,
+                                cacheHit: false,
+                                rawSize: 0,
+                                markdownSize: 0,
+                            },
+                        };
+                    }
+                    // Same-host redirect: validate the redirect URL's resolved IP before following
+                    try {
+                        await validateResolvedIp(redirectHost);
+                    }
+                    catch (err) {
+                        const msg = err instanceof Error ? err.message : String(err);
+                        return {
+                            content: [{ type: 'text', text: `Redirect URL rejected: ${msg}` }],
+                            details: { finalUrl: redirectUrl, statusCode: status, cacheHit: false, rawSize: 0, markdownSize: 0 },
+                        };
+                    }
+                    redirectCount++;
+                    if (redirectCount > maxRedirects) {
+                        return {
+                            content: [{ type: 'text', text: `Too many redirects (${maxRedirects}) for ${urlStr}` }],
+                            details: { finalUrl: currentUrl, statusCode: status, cacheHit: false, rawSize: 0, markdownSize: 0 },
+                        };
+                    }
+                    currentUrl = redirectUrl;
+                    continue;
+                }
+                // Not a redirect, break out of the loop
+                break;
+            }
+            const finalUrl = currentUrl;
+            const statusCode = response.status;
+            // Handle HTTP errors
+            if (statusCode === 404) {
+                return {
+                    content: [{ type: 'text', text: `Page not found: ${urlStr}` }],
+                    details: { finalUrl, statusCode, cacheHit: false, rawSize: 0, markdownSize: 0 },
+                };
+            }
+            if (statusCode === 403) {
+                return {
+                    content: [{ type: 'text', text: `Access forbidden: ${urlStr}. This may require authentication. Check if an MCP tool provides access.` }],
+                    details: { finalUrl, statusCode, cacheHit: false, rawSize: 0, markdownSize: 0 },
+                };
+            }
+            if (statusCode >= 500) {
+                return {
+                    content: [{ type: 'text', text: `Server error (${statusCode}): ${urlStr}` }],
+                    details: { finalUrl, statusCode, cacheHit: false, rawSize: 0, markdownSize: 0 },
+                };
+            }
+            // Read body
+            const rawBody = await response.text();
+            const rawSize = rawBody.length;
+            // Determine content type
+            const contentType = response.headers.get('content-type') ?? '';
+            let markdown;
+            if (contentType.includes('application/json')) {
+                // JSON: return as-is
+                markdown = rawBody;
+            }
+            else if (contentType.includes('text/plain')) {
+                // Plain text: return as-is
+                markdown = rawBody;
+            }
+            else {
+                // HTML: strip boilerplate and convert via Turndown
+                const cleaned = stripBoilerplateHtml(rawBody);
+                markdown = (await getTurndownService()).turndown(cleaned);
+            }
+            // Check for JavaScript-only pages
+            if (markdown.trim().length < 100 && rawBody.includes('<script')) {
+                return {
+                    content: [{ type: 'text', text: 'The page appears to require JavaScript to render. No extractable content found.' }],
+                    details: { finalUrl, statusCode, cacheHit: false, rawSize, markdownSize: markdown.length },
+                };
+            }
+            // Cache the result
+            cache.set(urlStr, {
+                content: markdown,
+                fetchedAt: Date.now(),
+                statusCode,
+                finalUrl,
+            });
+            // Summarize with utility model
+            const summary = await summarize(markdown, params.prompt, config.utilityComplete);
+            return {
+                content: [{ type: 'text', text: summary }],
+                details: {
+                    finalUrl,
+                    statusCode,
+                    cacheHit: false,
+                    rawSize,
+                    markdownSize: markdown.length,
+                },
+            };
+        },
+    };
+    return attachRuntimeAwareTool(tool, {
+        toolKind: 'WebFetch',
+        cloneForRuntime: (runtime) => createWebFetchTool({
+            ...config,
+            runtime,
+        }),
+    });
+}
+// ---------------------------------------------------------------------------
+// Summarization
+// ---------------------------------------------------------------------------
+/**
+ * Summarize page content using the utility model.
+ * Falls back to truncated content if the utility model is unavailable.
+ */
+/**
+ * Cap content sent to the utility model. This is purely a cost/latency
+ * guard for the summarization step and is independent of the agent-side
+ * result-persistence interceptor (which protects main-agent context).
+ */
+function capForUtilityModel(content) {
+    const maxChars = MAX_UTILITY_MODEL_INPUT_TOKENS * 4;
+    if (content.length <= maxChars)
+        return content;
+    return content.slice(0, maxChars) + '\n\n[Content truncated for summarization input]';
+}
+async function summarize(content, prompt, utilityComplete) {
+    if (!utilityComplete) {
+        // No utility model available; return raw content. The agent's
+        // result-persistence interceptor will bookend/persist if oversized.
+        return `[WebFetch: utility model not available. Returning raw content.]\n\n${content}`;
+    }
+    const summarizationInput = capForUtilityModel(content);
+    try {
+        const result = await utilityComplete({
+            systemPrompt: 'You are a web content analyst. Answer the user\'s question based on the provided web page content. Be concise and focused. If the content doesn\'t contain the answer, say so.',
+            messages: [
+                {
+                    role: 'user',
+                    content: `Question: ${prompt}\n\nWeb page content:\n${summarizationInput}`,
+                },
+            ],
+        });
+        if (typeof result === 'string')
+            return result;
+        if (result && typeof result === 'object' && 'text' in result) {
+            const textValue = result['text'];
+            if (typeof textValue === 'string')
+                return textValue;
+        }
+        return `[Summarization produced unexpected result type]\n\n${content.slice(0, 2000)}`;
+    }
+    catch {
+        // Summarization failed, return raw content. The agent's
+        // result-persistence interceptor will bookend/persist if oversized.
+        return `[WebFetch: summarization failed. Returning raw content.]\n\n${content}`;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/web-fetch/index.js.map

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

package/dist/tools/write.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Write tool: create a new file or overwrite an existing file.
+ *
+ * Enforces the read-before-write contract via ReadRegistry.
+ * Performs atomic writes (write to temp, then rename) to prevent
+ * partial writes on crash. Creates parent directories as needed.
+ *
+ * Reference: docs/cortex/tools/write.md
+ */
+import { Type, type Static } from 'typebox';
+import type { EditHistory } from './shared/edit-history.js';
+import type { FileMutationLock } from './shared/file-mutation-lock.js';
+import type { ReadRegistry } from './shared/read-registry.js';
+import type { ToolContentDetails } from '../types.js';
+import type { CortexToolRuntime } from './runtime.js';
+export declare const WriteParams: Type.TObject<{
+    file_path: Type.TString;
+    content: Type.TString;
+}>;
+export type WriteParamsType = Static<typeof WriteParams>;
+export interface DiffHunk {
+    oldStart: number;
+    oldLines: number;
+    newStart: number;
+    newLines: number;
+    lines: string[];
+}
+export interface WriteDetails {
+    filePath: string;
+    isCreate: boolean;
+    bytesWritten: number;
+    diff: DiffHunk[] | null;
+    originalContent: string | null;
+}
+export interface WriteToolConfig {
+    runtime?: CortexToolRuntime | undefined;
+    readRegistry?: ReadRegistry | undefined;
+    fileMutationLock?: FileMutationLock | undefined;
+    /**
+     * Undo stack. When provided, every successful write pushes a
+     * pre-mutation snapshot (or `null` when the file did not exist) so
+     * `UndoEdit` can restore the prior state.
+     */
+    editHistory?: EditHistory | undefined;
+}
+/**
+ * Compute a safe line-level diff between two strings.
+ *
+ * This intentionally emits at most one changed hunk. The UI only needs a
+ * compact, deterministic summary of the mutation, not a minimal diff.
+ */
+export declare function computeDiff(oldContent: string, newContent: string): DiffHunk[];
+export declare function createWriteTool(config: WriteToolConfig): {
+    name: string;
+    description: string;
+    parameters: typeof WriteParams;
+    execute: (params: WriteParamsType) => Promise<ToolContentDetails<WriteDetails>>;
+};
+//# sourceMappingURL=write.d.ts.map

package/dist/tools/write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../src/tools/write.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,EAAE,IAAI,EAAE,KAAK,MAAM,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAOtD,eAAO,MAAM,WAAW;;;EAGtB,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO,WAAW,CAAC,CAAC;AAMzD,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;IACxB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAMD,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACxC,YAAY,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IACxC,gBAAgB,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IAChD;;;;OAIG;IACH,WAAW,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CACvC;AAMD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,QAAQ,EAAE,CA0C9E;AAMD,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,WAAW,CAAC;IAC/B,OAAO,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,OAAO,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC,CAAC;CACjF,CA6PA"}