@nexus-cortex/executors 4.26.0

package/dist/implementations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/implementations/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,iBAAiB,CAAC;AAGhC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,gBAAgB,CAAC;AAG/B,cAAc,sBAAsB,CAAC;AAGrC,cAAc,eAAe,CAAC;AAG9B,cAAc,qBAAqB,CAAC;AAGpC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,gBAAgB,CAAC;AAG/B,cAAc,uBAAuB,CAAC;AAGtC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,iBAAiB,CAAC"}

package/dist/implementations/index.js

@@ -0,0 +1,28 @@
+/**
+ * Tool Executor Implementations
+ */
+// File operations
+export * from './file/index.js';
+// Search operations
+export * from './search/index.js';
+// Web operations
+export * from './web/index.js';
+// Execution operations
+export * from './execution/index.js';
+// UI/Planning operations
+export * from './ui/index.js';
+// Notebook operations
+export * from './notebook/index.js';
+// Historical operations
+export * from './historical/index.js';
+// MCP operations
+export * from './mcp/index.js';
+// Extension operations
+export * from './extensions/index.js';
+// Agent operations
+export * from './agent/index.js';
+// Addon operations
+export * from './addon/index.js';
+// Tmux operations
+export * from './tmux/index.js';
+//# sourceMappingURL=index.js.map

package/dist/implementations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/implementations/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,kBAAkB;AAClB,cAAc,iBAAiB,CAAC;AAEhC,oBAAoB;AACpB,cAAc,mBAAmB,CAAC;AAElC,iBAAiB;AACjB,cAAc,gBAAgB,CAAC;AAE/B,uBAAuB;AACvB,cAAc,sBAAsB,CAAC;AAErC,yBAAyB;AACzB,cAAc,eAAe,CAAC;AAE9B,sBAAsB;AACtB,cAAc,qBAAqB,CAAC;AAEpC,wBAAwB;AACxB,cAAc,uBAAuB,CAAC;AAEtC,iBAAiB;AACjB,cAAc,gBAAgB,CAAC;AAE/B,uBAAuB;AACvB,cAAc,uBAAuB,CAAC;AAEtC,mBAAmB;AACnB,cAAc,kBAAkB,CAAC;AAEjC,mBAAmB;AACnB,cAAc,kBAAkB,CAAC;AAEjC,kBAAkB;AAClB,cAAc,iBAAiB,CAAC"}

package/dist/implementations/mcp/DiscoveredMcpTool.d.ts

@@ -0,0 +1,58 @@
+/**
+ * DiscoveredMcpTool - Dynamic MCP Tool Wrapper
+ *
+ * Each tool discovered from an MCP server is wrapped in this class
+ * and registered as an individual tool in the tool registry.
+ *
+ * The LLM sees each MCP tool as a separate tool with its own name,
+ * description, and parameter schema.
+ */
+import { BaseTool, type ToolResult } from '../../base/index.js';
+import type { McpClientManager } from '@nexus-cortex/core';
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Parameters for discovered MCP tools
+ * The actual parameters are dynamic based on the tool's schema
+ */
+export type DiscoveredMcpToolParams = Record<string, unknown>;
+/**
+ * DiscoveredMcpTool - Wraps an individual MCP tool
+ *
+ * Each instance represents one tool from one MCP server.
+ * These tools are dynamically registered after MCP server connection.
+ *
+ * Example:
+ * - filesystem server exposes "read_file" → DiscoveredMcpTool("read_file", "filesystem", ...)
+ * - github server exposes "create_issue" → DiscoveredMcpTool("create_issue", "github", ...)
+ */
+export declare class DiscoveredMcpToolExecutor extends BaseTool<DiscoveredMcpToolParams, ToolResult> {
+    private serverName;
+    private serverToolName;
+    private toolDeclaration;
+    private mcpManagerGetter;
+    private mcpManager;
+    constructor(serverName: string, serverToolName: string, toolDeclaration: Tool, mcpManagerGetter: () => McpClientManager | undefined, toolNameOverride?: string);
+    validateToolParams(params: DiscoveredMcpToolParams): string | null;
+    getDescription(params: DiscoveredMcpToolParams): string;
+    execute(params: DiscoveredMcpToolParams, signal: AbortSignal, updateOutput?: (output: string) => void): Promise<ToolResult>;
+    /**
+     * Execute tool call with abort signal support
+     */
+    private executeWithAbort;
+    /**
+     * Format MCP tool result for display
+     */
+    private formatToolResult;
+    /**
+     * Format MCP content blocks (text, images, resources, etc.)
+     */
+    private formatMcpContent;
+}
+/**
+ * Generate a valid tool name from MCP tool name
+ * Follows Gemini API constraints:
+ * - Max 63 characters
+ * - Only alphanumeric, underscore, dash, dot
+ */
+export declare function generateValidToolName(name: string): string;
+//# sourceMappingURL=DiscoveredMcpTool.d.ts.map

package/dist/implementations/mcp/DiscoveredMcpTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DiscoveredMcpTool.d.ts","sourceRoot":"","sources":["../../../src/implementations/mcp/DiscoveredMcpTool.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEhE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE/D;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE9D;;;;;;;;;GASG;AACH,qBAAa,yBAA0B,SAAQ,QAAQ,CACrD,uBAAuB,EACvB,UAAU,CACX;IAIG,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,eAAe;IACvB,OAAO,CAAC,gBAAgB;IAN1B,OAAO,CAAC,UAAU,CAA+B;gBAGvC,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,IAAI,EACrB,gBAAgB,EAAE,MAAM,gBAAgB,GAAG,SAAS,EAC5D,gBAAgB,CAAC,EAAE,MAAM;IAwB3B,kBAAkB,CAAC,MAAM,EAAE,uBAAuB,GAAG,MAAM,GAAG,IAAI;IAUlE,cAAc,CAAC,MAAM,EAAE,uBAAuB,GAAG,MAAM;IAIjD,OAAO,CACX,MAAM,EAAE,uBAAuB,EAC/B,MAAM,EAAE,WAAW,EACnB,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GACtC,OAAO,CAAC,UAAU,CAAC;IA0HtB;;OAEG;YACW,gBAAgB;IAyC9B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA6BxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAwCzB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAU1D"}

package/dist/implementations/mcp/DiscoveredMcpTool.js

@@ -0,0 +1,269 @@
+/**
+ * DiscoveredMcpTool - Dynamic MCP Tool Wrapper
+ *
+ * Each tool discovered from an MCP server is wrapped in this class
+ * and registered as an individual tool in the tool registry.
+ *
+ * The LLM sees each MCP tool as a separate tool with its own name,
+ * description, and parameter schema.
+ */
+import { BaseTool } from '../../base/index.js';
+import { SchemaValidator } from '../../utils/SchemaValidator.js';
+/**
+ * DiscoveredMcpTool - Wraps an individual MCP tool
+ *
+ * Each instance represents one tool from one MCP server.
+ * These tools are dynamically registered after MCP server connection.
+ *
+ * Example:
+ * - filesystem server exposes "read_file" → DiscoveredMcpTool("read_file", "filesystem", ...)
+ * - github server exposes "create_issue" → DiscoveredMcpTool("create_issue", "github", ...)
+ */
+export class DiscoveredMcpToolExecutor extends BaseTool {
+    serverName;
+    serverToolName;
+    toolDeclaration;
+    mcpManagerGetter;
+    mcpManager;
+    constructor(serverName, serverToolName, toolDeclaration, mcpManagerGetter, toolNameOverride) {
+        // Generate a valid tool name for the LLM
+        const toolName = toolNameOverride ?? generateValidToolName(serverToolName);
+        // Use the tool's description from MCP server
+        const description = toolDeclaration.description || `Tool from MCP server '${serverName}'`;
+        // Use the tool's parameter schema from MCP server
+        const parameterSchema = (toolDeclaration.inputSchema || {
+            type: 'object',
+            properties: {},
+        }); // MCP schemas are dynamic
+        super(toolName, toolName, // displayName
+        `${description}\n\n*Source: ${serverName} MCP Server*`, parameterSchema);
+        this.serverName = serverName;
+        this.serverToolName = serverToolName;
+        this.toolDeclaration = toolDeclaration;
+        this.mcpManagerGetter = mcpManagerGetter;
+        this.mcpManager = mcpManagerGetter();
+    }
+    validateToolParams(params) {
+        // Validate against the MCP tool's schema
+        const schemaError = SchemaValidator.validate(this.parameterSchema, params);
+        if (schemaError) {
+            return schemaError;
+        }
+        return null;
+    }
+    getDescription(params) {
+        return `Calling ${this.serverToolName} on ${this.serverName} MCP server`;
+    }
+    async execute(params, signal, updateOutput) {
+        const startTime = Date.now();
+        try {
+            // Check for abort
+            if (signal.aborted) {
+                return {
+                    ...this.createErrorResult('Tool call was cancelled'),
+                    metadata: {
+                        executionTime: Date.now() - startTime,
+                        serverName: this.serverName,
+                        toolName: this.serverToolName,
+                    },
+                };
+            }
+            // Validate parameters
+            const validationError = this.validateToolParams(params);
+            if (validationError) {
+                return {
+                    ...this.createErrorResult(validationError),
+                    metadata: {
+                        executionTime: Date.now() - startTime,
+                        serverName: this.serverName,
+                        toolName: this.serverToolName,
+                    },
+                };
+            }
+            // Get MCP manager
+            if (!this.mcpManager) {
+                this.mcpManager = this.mcpManagerGetter();
+            }
+            if (!this.mcpManager) {
+                return {
+                    ...this.createErrorResult('MCP manager not available. MCP functionality requires proper configuration.'),
+                    metadata: {
+                        executionTime: Date.now() - startTime,
+                        serverName: this.serverName,
+                        toolName: this.serverToolName,
+                    },
+                };
+            }
+            // Check server is connected
+            if (!this.mcpManager.isServerConnected(this.serverName)) {
+                return {
+                    ...this.createErrorResult(`MCP server '${this.serverName}' is not connected.`),
+                    metadata: {
+                        executionTime: Date.now() - startTime,
+                        serverName: this.serverName,
+                        toolName: this.serverToolName,
+                    },
+                };
+            }
+            // Execute the tool call with abort support
+            const result = await this.executeWithAbort(this.mcpManager, this.serverName, this.serverToolName, params, signal);
+            // Check for abort after execution
+            if (signal.aborted) {
+                return {
+                    ...this.createErrorResult('Tool call was cancelled'),
+                    metadata: {
+                        executionTime: Date.now() - startTime,
+                        serverName: this.serverName,
+                        toolName: this.serverToolName,
+                    },
+                };
+            }
+            // Format the result
+            const formattedOutput = this.formatToolResult(result);
+            return {
+                ...this.createSuccessResult(formattedOutput),
+                metadata: {
+                    executionTime: Date.now() - startTime,
+                    serverName: this.serverName,
+                    toolName: this.serverToolName,
+                    resultType: typeof result,
+                },
+            };
+        }
+        catch (error) {
+            // Check for abort
+            if (signal.aborted) {
+                return {
+                    ...this.createErrorResult('Tool call was cancelled'),
+                    metadata: {
+                        executionTime: Date.now() - startTime,
+                        serverName: this.serverName,
+                        toolName: this.serverToolName,
+                    },
+                };
+            }
+            const errorMessage = error.message || String(error);
+            return {
+                ...this.createErrorResult(`Error calling MCP tool '${this.serverToolName}' on server '${this.serverName}': ${errorMessage}`),
+                metadata: {
+                    executionTime: Date.now() - startTime,
+                    serverName: this.serverName,
+                    toolName: this.serverToolName,
+                    error: errorMessage,
+                },
+            };
+        }
+    }
+    /**
+     * Execute tool call with abort signal support
+     */
+    async executeWithAbort(mcpManager, serverName, toolName, args, signal) {
+        return new Promise((resolve, reject) => {
+            if (signal.aborted) {
+                const error = new Error('Tool call aborted');
+                error.name = 'AbortError';
+                reject(error);
+                return;
+            }
+            const onAbort = () => {
+                cleanup();
+                const error = new Error('Tool call aborted');
+                error.name = 'AbortError';
+                reject(error);
+            };
+            const cleanup = () => {
+                signal.removeEventListener('abort', onAbort);
+            };
+            signal.addEventListener('abort', onAbort, { once: true });
+            mcpManager
+                .callTool(serverName, toolName, args)
+                .then((res) => {
+                cleanup();
+                resolve(res);
+            })
+                .catch((err) => {
+                cleanup();
+                reject(err);
+            });
+        });
+    }
+    /**
+     * Format MCP tool result for display
+     */
+    formatToolResult(result) {
+        if (result === null || result === undefined) {
+            return 'Tool executed successfully (no return value)';
+        }
+        // Handle MCP content blocks
+        if (Array.isArray(result.content)) {
+            return this.formatMcpContent(result.content);
+        }
+        // Handle direct result
+        if (typeof result === 'string') {
+            return result;
+        }
+        // Handle object result
+        if (typeof result === 'object') {
+            // Check if it's a simple text response
+            if (result.text) {
+                return result.text;
+            }
+            // Format as JSON
+            return '```json\n' + JSON.stringify(result, null, 2) + '\n```';
+        }
+        return String(result);
+    }
+    /**
+     * Format MCP content blocks (text, images, resources, etc.)
+     */
+    formatMcpContent(content) {
+        const parts = [];
+        for (const block of content) {
+            if (!block || typeof block !== 'object') {
+                continue;
+            }
+            switch (block.type) {
+                case 'text':
+                    if (block.text) {
+                        parts.push(block.text);
+                    }
+                    break;
+                case 'image':
+                case 'audio':
+                    parts.push(`[${block.type}: ${block.mimeType || 'unknown type'}]`);
+                    break;
+                case 'resource':
+                    if (block.resource?.text) {
+                        parts.push(block.resource.text);
+                    }
+                    else {
+                        parts.push(`[Embedded Resource: ${block.resource?.mimeType || 'unknown type'}]`);
+                    }
+                    break;
+                case 'resource_link':
+                    const title = block.title || block.name || 'Resource';
+                    parts.push(`[Link to ${title}: ${block.uri}]`);
+                    break;
+                default:
+                    parts.push(`[Unknown content type: ${block.type}]`);
+            }
+        }
+        return parts.length > 0 ? parts.join('\n') : 'Tool executed successfully';
+    }
+}
+/**
+ * Generate a valid tool name from MCP tool name
+ * Follows Gemini API constraints:
+ * - Max 63 characters
+ * - Only alphanumeric, underscore, dash, dot
+ */
+export function generateValidToolName(name) {
+    // Replace invalid characters with underscores
+    let validName = name.replace(/[^a-zA-Z0-9_.-]/g, '_');
+    // If longer than 63 characters, truncate middle with '___'
+    if (validName.length > 63) {
+        validName = validName.slice(0, 28) + '___' + validName.slice(-32);
+    }
+    return validName;
+}
+//# sourceMappingURL=DiscoveredMcpTool.js.map

package/dist/implementations/mcp/DiscoveredMcpTool.js.map

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

package/dist/implementations/mcp/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * MCP Tool Executors
+ *
+ * Dynamic MCP tool registration - each MCP tool is individually wrapped
+ * and registered as a separate tool in the tool registry.
+ */
+export { DiscoveredMcpToolExecutor, generateValidToolName } from './DiscoveredMcpTool.js';
+export type { DiscoveredMcpToolParams } from './DiscoveredMcpTool.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/implementations/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/implementations/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC1F,YAAY,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/implementations/mcp/index.js

@@ -0,0 +1,8 @@
+/**
+ * MCP Tool Executors
+ *
+ * Dynamic MCP tool registration - each MCP tool is individually wrapped
+ * and registered as a separate tool in the tool registry.
+ */
+export { DiscoveredMcpToolExecutor, generateValidToolName } from './DiscoveredMcpTool.js';
+//# sourceMappingURL=index.js.map

package/dist/implementations/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/implementations/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/implementations/notebook/NotebookEditTool.d.ts

@@ -0,0 +1,96 @@
+/**
+ * NotebookEdit Tool Executor
+ *
+ * Edit Jupyter notebook cells - supports replace, insert, and delete operations.
+ * Works with .ipynb files (JSON format).
+ */
+import { BaseTool, type ToolResult } from '../../base/index.js';
+import type { ExecutorConfig } from '../../base/ToolRegistry.js';
+/**
+ * Edit mode for notebook cell operations
+ */
+export type NotebookEditMode = 'replace' | 'insert' | 'delete';
+/**
+ * Cell type in Jupyter notebooks
+ */
+export type NotebookCellType = 'code' | 'markdown';
+/**
+ * Parameters for the NotebookEdit tool
+ */
+export interface NotebookEditToolParams {
+    /**
+     * Absolute path to the Jupyter notebook file
+     */
+    notebook_path: string;
+    /**
+     * ID of the cell to edit (optional for insert at end)
+     */
+    cell_id?: string;
+    /**
+     * Type of the cell (code or markdown)
+     */
+    cell_type?: NotebookCellType;
+    /**
+     * Edit operation: replace, insert, delete
+     */
+    edit_mode?: NotebookEditMode;
+    /**
+     * New source content for the cell
+     */
+    new_source: string;
+}
+/**
+ * NotebookEdit Tool Executor
+ *
+ * Features:
+ * - Read and parse .ipynb JSON files
+ * - Replace cell content by cell_id
+ * - Insert new cells at specific positions
+ * - Delete cells by cell_id
+ * - Preserve notebook metadata and structure
+ */
+export declare class NotebookEditTool extends BaseTool<NotebookEditToolParams, ToolResult> {
+    private config;
+    constructor(config: ExecutorConfig);
+    validateToolParams(params: NotebookEditToolParams): string | null;
+    getDescription(params: NotebookEditToolParams): string;
+    execute(params: NotebookEditToolParams, signal: AbortSignal, updateOutput?: (output: string) => void): Promise<ToolResult>;
+    /**
+     * Perform the edit operation on the notebook
+     */
+    private performEdit;
+    /**
+     * Get the cell ID from a cell (checks both cell.id and cell.metadata.id)
+     * Jupyter notebooks may store cell IDs in either location
+     */
+    private getCellId;
+    /**
+     * Find a cell by ID (checks both cell.id and cell.metadata.id)
+     */
+    private findCellIndex;
+    /**
+     * Replace an existing cell's content
+     */
+    private replaceCell;
+    /**
+     * Insert a new cell
+     */
+    private insertCell;
+    /**
+     * Delete a cell
+     */
+    private deleteCell;
+    /**
+     * Normalize source content to array of lines
+     */
+    private normalizeSource;
+    /**
+     * Generate a unique cell ID
+     */
+    private generateCellId;
+    /**
+     * Format success message
+     */
+    private formatSuccessMessage;
+}
+//# sourceMappingURL=NotebookEditTool.d.ts.map

package/dist/implementations/notebook/NotebookEditTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NotebookEditTool.d.ts","sourceRoot":"","sources":["../../../src/implementations/notebook/NotebookEditTool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEhE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAIjE;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE/D;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,UAAU,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAE7B;;OAEG;IACH,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAE7B;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAwBD;;;;;;;;;GASG;AACH,qBAAa,gBAAiB,SAAQ,QAAQ,CAC5C,sBAAsB,EACtB,UAAU,CACX;IACa,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,cAAc;IAwC1C,kBAAkB,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,GAAG,IAAI;IA8CjE,cAAc,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM;IAMhD,OAAO,CACX,MAAM,EAAE,sBAAsB,EAC9B,MAAM,EAAE,WAAW,EACnB,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GACtC,OAAO,CAAC,UAAU,CAAC;IA4ItB;;OAEG;YACW,WAAW;IAsBzB;;;OAGG;IACH,OAAO,CAAC,SAAS;IAIjB;;OAEG;IACH,OAAO,CAAC,aAAa;IAIrB;;OAEG;IACH,OAAO,CAAC,WAAW;IA6CnB;;OAEG;IACH,OAAO,CAAC,UAAU;IAiDlB;;OAEG;IACH,OAAO,CAAC,UAAU;IA0BlB;;OAEG;IACH,OAAO,CAAC,eAAe;IAQvB;;OAEG;IACH,OAAO,CAAC,cAAc;IAKtB;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAgC7B"}