crewly 1.3.31 → 1.4.0

package/dist/backend/backend/src/services/agent/crewly-agent/rate-limiter.d.ts

@@ -0,0 +1,143 @@
+/**
+ * Rate Limiter for Crewly Agent API Calls
+ *
+ * Provides token-bucket rate limiting, message coalescing, and 429 retry
+ * logic to prevent Gemini API quota exhaustion when multiple agents are
+ * actively generating messages.
+ *
+ * @module services/agent/crewly-agent/rate-limiter
+ */
+/**
+ * Configuration for the rate limiter.
+ */
+export interface RateLimiterConfig {
+    /** Maximum requests allowed per window */
+    maxRequestsPerWindow: number;
+    /** Time window in milliseconds */
+    windowMs: number;
+    /** Maximum retry attempts for 429 errors */
+    maxRetries: number;
+    /** Initial backoff delay in milliseconds for 429 retries */
+    initialBackoffMs: number;
+    /** Backoff multiplier for exponential retry */
+    backoffMultiplier: number;
+    /** Maximum backoff delay in milliseconds */
+    maxBackoffMs: number;
+    /** Coalescing window — how long to wait for additional messages before processing (ms) */
+    coalesceWindowMs: number;
+}
+/**
+ * Default rate limiter configuration.
+ */
+export declare const RATE_LIMITER_DEFAULTS: RateLimiterConfig;
+/**
+ * Token-bucket rate limiter with message coalescing and 429 retry.
+ *
+ * Features:
+ * - **Rate limiting**: Enforces max requests per time window using a sliding window.
+ * - **Message coalescing**: Groups messages arriving within a short window into one.
+ * - **429 retry**: Wraps API calls with exponential backoff on quota errors.
+ *
+ * @example
+ * ```typescript
+ * const limiter = new RateLimiter<AgentRunResult>();
+ * const result = await limiter.enqueue('Check status', undefined, async (msg) => {
+ *   return agentRunner.run(msg);
+ * });
+ * ```
+ */
+export declare class RateLimiter<T> {
+    private config;
+    private requestTimestamps;
+    private queue;
+    private processing;
+    private coalesceTimer;
+    /**
+     * Create a new RateLimiter instance.
+     *
+     * @param config - Optional partial config overrides
+     */
+    constructor(config?: Partial<RateLimiterConfig>);
+    /**
+     * Enqueue a message for rate-limited processing.
+     *
+     * If multiple messages arrive within the coalescing window, they are
+     * merged into a single request to reduce API call count.
+     *
+     * @param message - Message to process
+     * @param metadata - Optional metadata
+     * @param handler - Async function that performs the actual API call
+     * @returns Result from the handler
+     */
+    enqueue(message: string, metadata: Record<string, string> | undefined, handler: (message: string, metadata?: Record<string, string>) => Promise<T>): Promise<T>;
+    /**
+     * Get the current number of messages in the queue.
+     *
+     * @returns Queue length
+     */
+    getQueueLength(): number;
+    /**
+     * Check if the rate limiter is currently processing.
+     *
+     * @returns True if processing
+     */
+    isProcessing(): boolean;
+    /**
+     * Get the number of requests made in the current window.
+     *
+     * @returns Request count in current window
+     */
+    getRequestCountInWindow(): number;
+    /**
+     * Get the current configuration.
+     *
+     * @returns Rate limiter configuration
+     */
+    getConfig(): RateLimiterConfig;
+    /**
+     * Reset internal state (for testing).
+     */
+    reset(): void;
+    /**
+     * Process the queue: coalesce messages, enforce rate limit, execute with retry.
+     *
+     * @param handler - The actual API call handler
+     */
+    private processQueue;
+    /**
+     * Wait until we have capacity in the rate limit window.
+     */
+    private waitForCapacity;
+    /**
+     * Remove timestamps older than the current window.
+     */
+    private pruneOldTimestamps;
+    /**
+     * Coalesce multiple queued messages into a single message.
+     *
+     * If there's only one message, it passes through unchanged.
+     * Multiple messages are joined with a separator and a header.
+     *
+     * @param batch - Array of queued messages to coalesce
+     * @returns Single coalesced message and metadata from the most recent item
+     */
+    private coalesceMessages;
+    /**
+     * Execute the handler with exponential backoff retry on 429/quota errors.
+     *
+     * @param message - Message to send
+     * @param metadata - Optional metadata
+     * @param handler - The API call handler
+     * @returns Handler result
+     * @throws Error after max retries exhausted
+     */
+    private executeWithRetry;
+    /**
+     * Check if an error is retryable (429 or quota-related).
+     *
+     * @param error - The error to check
+     * @returns True if the error should be retried
+     */
+    private isRetryableError;
+}
+//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/backend/backend/src/services/agent/crewly-agent/rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/agent/crewly-agent/rate-limiter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0CAA0C;IAC1C,oBAAoB,EAAE,MAAM,CAAC;IAC7B,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,gBAAgB,EAAE,MAAM,CAAC;IACzB,+CAA+C;IAC/C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,4CAA4C;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB,0FAA0F;IAC1F,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,iBAQnC,CAAC;AAkBF;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,WAAW,CAAC,CAAC;IACxB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,iBAAiB,CAAgB;IACzC,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,aAAa,CAA8C;IAEnE;;;;OAIG;gBACS,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC;IAI/C;;;;;;;;;;OAUG;IACH,OAAO,CACL,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EAC5C,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAC1E,OAAO,CAAC,CAAC,CAAC;IA0Bb;;;;OAIG;IACH,cAAc,IAAI,MAAM;IAIxB;;;;OAIG;IACH,YAAY,IAAI,OAAO;IAIvB;;;;OAIG;IACH,uBAAuB,IAAI,MAAM;IAKjC;;;;OAIG;IACH,SAAS,IAAI,iBAAiB;IAI9B;;OAEG;IACH,KAAK,IAAI,IAAI;IAUb;;;;OAIG;YACW,YAAY;IAiD1B;;OAEG;YACW,eAAe;IAgB7B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAK1B;;;;;;;;OAQG;IACH,OAAO,CAAC,gBAAgB;IAkBxB;;;;;;;;OAQG;YACW,gBAAgB;IAqC9B;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;CAUzB"}

package/dist/backend/backend/src/services/agent/crewly-agent/rate-limiter.js

@@ -0,0 +1,264 @@
+/**
+ * Rate Limiter for Crewly Agent API Calls
+ *
+ * Provides token-bucket rate limiting, message coalescing, and 429 retry
+ * logic to prevent Gemini API quota exhaustion when multiple agents are
+ * actively generating messages.
+ *
+ * @module services/agent/crewly-agent/rate-limiter
+ */
+/**
+ * Default rate limiter configuration.
+ */
+export const RATE_LIMITER_DEFAULTS = {
+    maxRequestsPerWindow: 10,
+    windowMs: 60_000,
+    maxRetries: 3,
+    initialBackoffMs: 5_000,
+    backoffMultiplier: 2,
+    maxBackoffMs: 60_000,
+    coalesceWindowMs: 2_000,
+};
+/**
+ * Token-bucket rate limiter with message coalescing and 429 retry.
+ *
+ * Features:
+ * - **Rate limiting**: Enforces max requests per time window using a sliding window.
+ * - **Message coalescing**: Groups messages arriving within a short window into one.
+ * - **429 retry**: Wraps API calls with exponential backoff on quota errors.
+ *
+ * @example
+ * ```typescript
+ * const limiter = new RateLimiter<AgentRunResult>();
+ * const result = await limiter.enqueue('Check status', undefined, async (msg) => {
+ *   return agentRunner.run(msg);
+ * });
+ * ```
+ */
+export class RateLimiter {
+    config;
+    requestTimestamps = [];
+    queue = [];
+    processing = false;
+    coalesceTimer = null;
+    /**
+     * Create a new RateLimiter instance.
+     *
+     * @param config - Optional partial config overrides
+     */
+    constructor(config) {
+        this.config = { ...RATE_LIMITER_DEFAULTS, ...config };
+    }
+    /**
+     * Enqueue a message for rate-limited processing.
+     *
+     * If multiple messages arrive within the coalescing window, they are
+     * merged into a single request to reduce API call count.
+     *
+     * @param message - Message to process
+     * @param metadata - Optional metadata
+     * @param handler - Async function that performs the actual API call
+     * @returns Result from the handler
+     */
+    enqueue(message, metadata, handler) {
+        return new Promise((resolve, reject) => {
+            this.queue.push({
+                message,
+                metadata,
+                resolve,
+                reject,
+                enqueuedAt: Date.now(),
+            });
+            // Reset coalesce timer — wait for more messages before processing
+            if (this.coalesceTimer) {
+                clearTimeout(this.coalesceTimer);
+            }
+            this.coalesceTimer = setTimeout(() => {
+                this.coalesceTimer = null;
+                if (!this.processing) {
+                    this.processQueue(handler).catch(() => {
+                        // Errors are already routed to individual promise reject callbacks
+                    });
+                }
+            }, this.config.coalesceWindowMs);
+        });
+    }
+    /**
+     * Get the current number of messages in the queue.
+     *
+     * @returns Queue length
+     */
+    getQueueLength() {
+        return this.queue.length;
+    }
+    /**
+     * Check if the rate limiter is currently processing.
+     *
+     * @returns True if processing
+     */
+    isProcessing() {
+        return this.processing;
+    }
+    /**
+     * Get the number of requests made in the current window.
+     *
+     * @returns Request count in current window
+     */
+    getRequestCountInWindow() {
+        this.pruneOldTimestamps();
+        return this.requestTimestamps.length;
+    }
+    /**
+     * Get the current configuration.
+     *
+     * @returns Rate limiter configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Reset internal state (for testing).
+     */
+    reset() {
+        this.requestTimestamps = [];
+        this.queue = [];
+        this.processing = false;
+        if (this.coalesceTimer) {
+            clearTimeout(this.coalesceTimer);
+            this.coalesceTimer = null;
+        }
+    }
+    /**
+     * Process the queue: coalesce messages, enforce rate limit, execute with retry.
+     *
+     * @param handler - The actual API call handler
+     */
+    async processQueue(handler) {
+        this.processing = true;
+        try {
+            while (this.queue.length > 0) {
+                // Wait for rate limit window if needed
+                await this.waitForCapacity();
+                // Coalesce all pending messages into one
+                const batch = this.queue.splice(0, this.queue.length);
+                const coalesced = this.coalesceMessages(batch);
+                // Record this request timestamp
+                this.requestTimestamps.push(Date.now());
+                // Execute with 429 retry
+                try {
+                    const result = await this.executeWithRetry(coalesced.message, coalesced.metadata, handler);
+                    // Resolve all promises in the batch with the same result
+                    for (const item of batch) {
+                        item.resolve(result);
+                    }
+                }
+                catch (error) {
+                    // Reject all promises in the batch
+                    const err = error instanceof Error ? error : new Error(String(error));
+                    for (const item of batch) {
+                        item.reject(err);
+                    }
+                }
+            }
+        }
+        finally {
+            this.processing = false;
+            // Check if more messages arrived while processing
+            if (this.queue.length > 0) {
+                this.processQueue(handler).catch(() => {
+                    // Errors are already routed to individual promise reject callbacks
+                });
+            }
+        }
+    }
+    /**
+     * Wait until we have capacity in the rate limit window.
+     */
+    async waitForCapacity() {
+        this.pruneOldTimestamps();
+        while (this.requestTimestamps.length >= this.config.maxRequestsPerWindow) {
+            // Calculate how long to wait until the oldest request falls out of the window
+            const oldestTimestamp = this.requestTimestamps[0];
+            const waitMs = (oldestTimestamp + this.config.windowMs) - Date.now() + 100; // +100ms buffer
+            if (waitMs > 0) {
+                await new Promise((resolve) => setTimeout(resolve, waitMs));
+            }
+            this.pruneOldTimestamps();
+        }
+    }
+    /**
+     * Remove timestamps older than the current window.
+     */
+    pruneOldTimestamps() {
+        const cutoff = Date.now() - this.config.windowMs;
+        this.requestTimestamps = this.requestTimestamps.filter((ts) => ts > cutoff);
+    }
+    /**
+     * Coalesce multiple queued messages into a single message.
+     *
+     * If there's only one message, it passes through unchanged.
+     * Multiple messages are joined with a separator and a header.
+     *
+     * @param batch - Array of queued messages to coalesce
+     * @returns Single coalesced message and metadata from the most recent item
+     */
+    coalesceMessages(batch) {
+        if (batch.length === 1) {
+            return { message: batch[0].message, metadata: batch[0].metadata };
+        }
+        // Use metadata from the most recent message
+        const latestMetadata = batch[batch.length - 1].metadata;
+        // Coalesce messages with a numbered separator
+        const parts = batch.map((item, index) => {
+            return `[Message ${index + 1}/${batch.length}]\n${item.message}`;
+        });
+        const coalesced = `${batch.length} messages received while rate-limited. Process them together:\n\n${parts.join('\n\n---\n\n')}`;
+        return { message: coalesced, metadata: latestMetadata };
+    }
+    /**
+     * Execute the handler with exponential backoff retry on 429/quota errors.
+     *
+     * @param message - Message to send
+     * @param metadata - Optional metadata
+     * @param handler - The API call handler
+     * @returns Handler result
+     * @throws Error after max retries exhausted
+     */
+    async executeWithRetry(message, metadata, handler) {
+        let lastError = null;
+        for (let attempt = 0; attempt <= this.config.maxRetries; attempt++) {
+            try {
+                return await handler(message, metadata);
+            }
+            catch (error) {
+                lastError = error instanceof Error ? error : new Error(String(error));
+                // Only retry on 429 / quota errors
+                if (!this.isRetryableError(lastError)) {
+                    throw lastError;
+                }
+                if (attempt >= this.config.maxRetries) {
+                    break;
+                }
+                // Exponential backoff
+                const backoffMs = Math.min(this.config.initialBackoffMs * Math.pow(this.config.backoffMultiplier, attempt), this.config.maxBackoffMs);
+                await new Promise((resolve) => setTimeout(resolve, backoffMs));
+            }
+        }
+        throw new Error(`Rate limit retries exhausted (${this.config.maxRetries} attempts). Last error: ${lastError?.message}`);
+    }
+    /**
+     * Check if an error is retryable (429 or quota-related).
+     *
+     * @param error - The error to check
+     * @returns True if the error should be retried
+     */
+    isRetryableError(error) {
+        const message = error.message.toLowerCase();
+        return (message.includes('429') ||
+            message.includes('quota') ||
+            message.includes('rate limit') ||
+            message.includes('resource_exhausted') ||
+            message.includes('too many requests'));
+    }
+}
+//# sourceMappingURL=rate-limiter.js.map

package/dist/backend/backend/src/services/agent/crewly-agent/rate-limiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.js","sourceRoot":"","sources":["../../../../../../../backend/src/services/agent/crewly-agent/rate-limiter.ts"],"names":[],"mappings":"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"}

package/dist/backend/backend/src/services/agent/crewly-agent/smoke-test.js

@@ -22,7 +22,7 @@ if (!API_KEY) {
 async function main() {
     console.log('=== Crewly Agent Runtime Smoke Test ===\n');
     console.log('Provider: google');
-    console.log('Model: gemini-2.5-flash');
+    console.log('Model: gemini-2.0-flash');
     console.log('API Key: ...%s', API_KEY.slice(-6));
     console.log();
     // Create a minimal mock SessionCommandHelper (not used by in-process runtime)
@@ -37,7 +37,7 @@ async function main() {
         // Step 1: Initialize with Gemini
         console.log('[1/4] Initializing runtime...');
         await runtime.initializeInProcess('smoke-test-session', {
-            model: { provider: 'google', modelId: 'gemini-2.5-flash' },
+            model: { provider: 'google', modelId: 'gemini-2.0-flash' },
             maxSteps: 5,
             systemPrompt: `You are a test agent. When asked to check team status, you MUST call the get_team_status tool. After getting the result, summarize it briefly. Always use tools when available.`,
         });

package/dist/backend/backend/src/services/agent/crewly-agent/tool-registry.d.ts

@@ -9,6 +9,57 @@
  */
 import type { CrewlyApiClient } from './api-client.js';
 import type { ToolDefinition, ToolCallbacks, ToolSensitivity } from './types.js';
+/**
+ * Bash commands that require explicit approval before execution.
+ * These are dangerous but not catastrophic — they modify remote state,
+ * delete files, or interact with container/network infrastructure.
+ *
+ * Matched against the raw command string (case-insensitive, word-boundary).
+ */
+export declare const APPROVAL_REQUIRED_BASH_PATTERNS: Array<{
+    pattern: RegExp;
+    label: string;
+}>;
+/**
+ * Validate a shell command against the blocklist.
+ *
+ * @param command - Raw shell command string
+ * @returns Error message if blocked, or null if allowed
+ */
+export declare function validateBashCommand(command: string): string | null;
+/**
+ * Check if a bash command matches any approval-required pattern.
+ *
+ * @param command - Raw shell command string
+ * @returns Matching label if approval is required, or null if safe to proceed
+ */
+export declare function checkBashApprovalRequired(command: string): string | null;
+/**
+ * Strip [NOTIFY]...[/NOTIFY] markers from text.
+ *
+ * The crewly-agent model sometimes wraps tool arguments in NOTIFY markers
+ * intended for the terminal gateway routing layer. When this leaks into
+ * reply_slack or other outward-facing tools, the raw markers appear in
+ * the Slack message. This function extracts the body content (after the
+ * --- separator if present) or the full block content.
+ *
+ * @param text - Text that may contain NOTIFY markers
+ * @returns Clean text with markers stripped and body content extracted
+ */
+export declare function stripNotifyMarkers(text: string): string;
+/**
+ * Convert GitHub-flavored Markdown to Slack mrkdwn format (#181).
+ *
+ * Transformations applied (in order):
+ * 1. Escape &, <, > to HTML entities (Slack requirement)
+ * 2. Convert fenced code blocks (```lang\n...\n```) to Slack code blocks
+ * 3. Convert **bold** to *bold* (Slack uses single asterisks)
+ * 4. Convert [text](url) links to <url|text> (Slack link format)
+ *
+ * @param text - Markdown-formatted text
+ * @returns Text formatted for Slack mrkdwn
+ */
+export declare function convertMarkdownToSlackMrkdwn(text: string): string;
 /**
  * Sensitivity classification for each tool.
  * Used by the audit trail to classify tool invocations.
@@ -27,7 +78,10 @@ export declare const TOOL_SENSITIVITY: Record<string, ToolSensitivity>;
  * @param callbacks - Optional callbacks for compaction and audit logging
  * @returns Object of named tools ready to pass to generateText
  */
-export declare function createTools(client: CrewlyApiClient, sessionName: string, projectPath?: string, callbacks?: ToolCallbacks): Record<string, ToolDefinition>;
+export declare function createTools(client: CrewlyApiClient, sessionName: string, projectPath?: string, callbacks?: ToolCallbacks, conversationId?: string, slackContext?: {
+    channelId: string;
+    threadTs?: string;
+}, mcpTools?: Record<string, ToolDefinition>): Record<string, ToolDefinition>;
 /**
  * Get the list of tool names available in the registry.
  *

package/dist/backend/backend/src/services/agent/crewly-agent/tool-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/agent/crewly-agent/tool-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,eAAe,EAAmC,MAAM,YAAY,CAAC;AAmBlH;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CA8B5D,CAAC;AA0HF;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CA+lBzJ;AA2BD;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,MAAM,EAAE,CAUvC"}
+{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/agent/crewly-agent/tool-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,eAAe,EAAoD,MAAM,YAAY,CAAC;AA0BnI;;;;;;GAMG;AACH,eAAO,MAAM,+BAA+B,EAAE,KAAK,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CASrF,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOlE;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOxE;AAuED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAavD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAoBjE;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAwC5D,CAAC;AAkIF;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,aAAa,EAAE,cAAc,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAikCtR;AA2BD;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,MAAM,EAAE,CAWvC"}