@animalabs/agent-framework 0.1.0

package/dist/src/mcpl/server-connection.js

@@ -0,0 +1,559 @@
+/**
+ * McplServerConnection — manages a single JSON-RPC 2.0 connection to an MCPL server.
+ *
+ * Spawns a child process (stdio transport), performs the MCP initialize handshake
+ * with MCPL capability negotiation, and provides typed methods for all outbound
+ * MCPL messages plus EventEmitter events for inbound messages.
+ */
+import { spawn } from 'node:child_process';
+import { createInterface } from 'node:readline';
+import { EventEmitter } from 'node:events';
+import { McplMethod } from './types.js';
+/** Timeout for the initialize handshake in milliseconds.
+ *  Spring Boot + JDA servers can take 5-10s to boot, so 30s is safe. */
+const INITIALIZE_TIMEOUT_MS = 30_000;
+/** MCP protocol version used in the initialize handshake. */
+const MCP_PROTOCOL_VERSION = '2024-11-05';
+/**
+ * McplServerConnection manages a single JSON-RPC 2.0 connection to an
+ * MCPL server over stdio. Use the static `connect()` factory to create
+ * and initialize a connection.
+ *
+ * Events emitted:
+ * - `'push-event'`        — Server sent `push/event`
+ * - `'inference-request'`  — Server sent `inference/request`
+ * - `'scope-elevate'`      — Server sent `scope/elevate`
+ * - `'channels-register'`  — Server sent `channels/register`
+ * - `'channels-changed'`   — Server sent `channels/changed`
+ * - `'channels-incoming'`  — Server sent `channels/incoming`
+ * - `'feature-sets-changed'` — Server sent `featureSets/changed`
+ * - `'error'`              — Connection-level error
+ * - `'close'`              — Connection closed
+ */
+export class McplServerConnection extends EventEmitter {
+    /** Unique server identifier from config. */
+    id;
+    /** MCPL capabilities negotiated during the initialize handshake, or null if the server does not support MCPL. */
+    capabilities;
+    process;
+    readline;
+    nextRequestId = 1;
+    pendingRequests = new Map();
+    closed = false;
+    // Event buffering: events emitted before ready() are queued, not lost
+    readyFlag = false;
+    bufferedEvents = [];
+    // Reconnect state (adapted from Anarchid/agent-framework@mcpl-module-proto)
+    config = null;
+    hostCapabilities = null;
+    reconnectEnabled = false;
+    reconnectIntervalMs = 5000;
+    reconnectTimer = null;
+    /**
+     * Private constructor. Use `McplServerConnection.connect()` instead.
+     */
+    constructor(id, capabilities, childProcess, readline) {
+        super();
+        this.id = id;
+        this.capabilities = capabilities;
+        this.process = childProcess;
+        this.readline = readline;
+        // Skip setup for disconnected stubs (process/readline are null)
+        if (childProcess && readline) {
+            this.setupMessageRouting();
+            this.setupLifecycle();
+        }
+    }
+    // ==========================================================================
+    // Event buffering
+    // ==========================================================================
+    /**
+     * Mark the connection as ready — flushes any events that arrived between
+     * construction (when setupMessageRouting starts emitting) and now (when
+     * the caller has attached listeners via wireMcplEvents).
+     */
+    ready() {
+        this.readyFlag = true;
+        for (const { event, args } of this.bufferedEvents) {
+            super.emit(event, ...args);
+        }
+        this.bufferedEvents = [];
+    }
+    /**
+     * Override emit to buffer server→host events until ready() is called.
+     * Lifecycle events ('close', 'error', 'reconnect') always pass through.
+     */
+    emit(event, ...args) {
+        const name = typeof event === 'string' ? event : '';
+        if (this.readyFlag || name === 'close' || name === 'error' || name === 'reconnect') {
+            return super.emit(event, ...args);
+        }
+        this.bufferedEvents.push({ event: name, args });
+        return true;
+    }
+    // ==========================================================================
+    // Static factory
+    // ==========================================================================
+    /**
+     * Spawn a server process, perform the MCP initialize handshake with MCPL
+     * capability negotiation, and return a ready-to-use connection.
+     *
+     * Throws if the process cannot be spawned or the handshake times out.
+     */
+    static async connect(config, hostCapabilities) {
+        const child = spawn(config.command, config.args ?? [], {
+            stdio: ['pipe', 'pipe', 'pipe'],
+            env: { ...process.env, ...config.env },
+        });
+        // Fail fast if the process exits before the handshake completes
+        const earlyExitPromise = new Promise((_resolve, reject) => {
+            child.on('error', (err) => {
+                reject(new Error(`Failed to spawn MCPL server "${config.id}": ${err.message}`));
+            });
+            child.on('exit', (code) => {
+                reject(new Error(`MCPL server "${config.id}" exited before handshake (code ${code})`));
+            });
+        });
+        // Set up readline for newline-delimited JSON on stdout
+        const rl = createInterface({ input: child.stdout });
+        // -----------------------------------------------------------------------
+        // Perform initialize handshake
+        // -----------------------------------------------------------------------
+        // Step 1: Send `initialize` request
+        const initId = 0; // use id=0 for the handshake
+        const initRequest = {
+            jsonrpc: '2.0',
+            method: 'initialize',
+            id: initId,
+            params: {
+                protocolVersion: MCP_PROTOCOL_VERSION,
+                capabilities: {
+                    experimental: {
+                        mcpl: hostCapabilities,
+                    },
+                },
+                clientInfo: {
+                    name: 'agent-framework',
+                    version: '1.0.0',
+                },
+            },
+        };
+        child.stdin.write(JSON.stringify(initRequest) + '\n');
+        // Step 2: Wait for the initialize response
+        const initResponse = await Promise.race([
+            new Promise((resolve, reject) => {
+                const onLine = (line) => {
+                    try {
+                        const msg = JSON.parse(line);
+                        if (msg.id === initId) {
+                            rl.off('line', onLine);
+                            if (msg.error) {
+                                reject(new Error(`MCPL server "${config.id}" initialize error: ${msg.error.message}`));
+                            }
+                            else {
+                                resolve(msg);
+                            }
+                        }
+                    }
+                    catch {
+                        // Ignore non-JSON lines (e.g. logback output from Java servers)
+                    }
+                };
+                rl.on('line', onLine);
+            }),
+            earlyExitPromise,
+            new Promise((_resolve, reject) => setTimeout(() => {
+                reject(new Error(`MCPL server "${config.id}" initialize handshake timed out`));
+            }, INITIALIZE_TIMEOUT_MS)),
+        ]);
+        // Parse MCPL capabilities from the response
+        const result = initResponse.result;
+        const caps = result?.capabilities;
+        const experimental = caps?.experimental;
+        const mcplCaps = experimental?.mcpl ?? null;
+        // Step 3: Send `initialized` notification (no id)
+        const initializedNotification = {
+            jsonrpc: '2.0',
+            method: 'notifications/initialized',
+        };
+        child.stdin.write(JSON.stringify(initializedNotification) + '\n');
+        // Remove the early-exit listener so normal close handling takes over
+        child.removeAllListeners('exit');
+        child.removeAllListeners('error');
+        const connection = new McplServerConnection(config.id, mcplCaps, child, rl);
+        // Store config for reconnection
+        if (config.reconnect) {
+            connection.config = config;
+            connection.hostCapabilities = hostCapabilities;
+            connection.reconnectEnabled = true;
+            connection.reconnectIntervalMs = config.reconnectIntervalMs ?? 5000;
+        }
+        return connection;
+    }
+    /**
+     * Connect with reconnect support.
+     * When `config.reconnect` is true and the initial connection fails,
+     * resolves immediately with null capabilities and retries in the background.
+     * Adapted from Anarchid/agent-framework@mcpl-module-proto.
+     */
+    static async connectWithReconnect(config, hostCapabilities) {
+        try {
+            return await McplServerConnection.connect(config, hostCapabilities);
+        }
+        catch (error) {
+            if (!config.reconnect) {
+                throw error;
+            }
+            // Non-blocking start: create a disconnected stub that will reconnect in background
+            console.error(`MCPL server "${config.id}" initial connect failed, will retry:`, error.message);
+            return McplServerConnection.createDisconnectedStub(config, hostCapabilities);
+        }
+    }
+    /**
+     * Create a disconnected stub connection that will reconnect in the background.
+     * Used when initial connect fails and reconnect is enabled.
+     * @internal
+     */
+    static createDisconnectedStub(config, hostCapabilities) {
+        // Use null! for process/readline since the connection is closed
+        const stub = new McplServerConnection(config.id, null, null, null);
+        stub.closed = true;
+        stub.config = config;
+        stub.hostCapabilities = hostCapabilities;
+        stub.reconnectEnabled = true;
+        stub.reconnectIntervalMs = config.reconnectIntervalMs ?? 5000;
+        // Schedule background reconnect
+        stub.scheduleReconnect();
+        return stub;
+    }
+    /**
+     * Extract internals for transfer during reconnection.
+     * Strips the source connection — caller takes ownership of the process/readline.
+     * @internal Used only by attemptReconnect().
+     */
+    extractInternals() {
+        const result = { process: this.process, readline: this.readline };
+        // Prevent the source connection from killing the transferred process
+        this.closed = true;
+        return result;
+    }
+    // ==========================================================================
+    // Outbound requests (return Promises)
+    // ==========================================================================
+    /** Send `context/beforeInference` and await result. */
+    sendBeforeInference(params) {
+        return this.sendRequest(McplMethod.BeforeInference, params);
+    }
+    /**
+     * Send `context/afterInference`.
+     * When `blocking` is true, sends as a request and awaits the result.
+     * When `blocking` is false (or omitted), sends as a notification.
+     */
+    sendAfterInference(params, blocking) {
+        if (blocking) {
+            return this.sendRequest(McplMethod.AfterInference, params);
+        }
+        this.sendNotification(McplMethod.AfterInference, params);
+        return Promise.resolve();
+    }
+    /** Send `featureSets/update` notification. */
+    sendFeatureSetsUpdate(params) {
+        this.sendNotification(McplMethod.FeatureSetsUpdate, params);
+    }
+    /** Send `inference/chunk` notification. */
+    sendInferenceChunk(params) {
+        this.sendNotification(McplMethod.InferenceChunk, params);
+    }
+    /** Send `state/rollback` request and await result. */
+    sendStateRollback(params) {
+        return this.sendRequest(McplMethod.StateRollback, params);
+    }
+    /** Send `channels/open` request and await result. */
+    sendChannelsOpen(params) {
+        return this.sendRequest(McplMethod.ChannelsOpen, params);
+    }
+    /** Send `channels/close` request and await result. */
+    sendChannelsClose(params) {
+        return this.sendRequest(McplMethod.ChannelsClose, params);
+    }
+    /** Send `channels/list` request and await result. */
+    sendChannelsList() {
+        return this.sendRequest(McplMethod.ChannelsList, {});
+    }
+    /**
+     * Send `channels/publish`.
+     * May be sent as a request (if an ACK is desired) or notification.
+     * When `params.stream` is true, sends as a notification (no ACK).
+     */
+    sendChannelsPublish(params) {
+        if (params.stream) {
+            this.sendNotification(McplMethod.ChannelsPublish, params);
+            return Promise.resolve();
+        }
+        return this.sendRequest(McplMethod.ChannelsPublish, params);
+    }
+    /** Send `channels/outgoing/chunk` notification. */
+    sendChannelsOutgoingChunk(params) {
+        this.sendNotification(McplMethod.ChannelsOutgoingChunk, params);
+    }
+    /** Send `channels/outgoing/complete` notification. */
+    sendChannelsOutgoingComplete(params) {
+        this.sendNotification(McplMethod.ChannelsOutgoingComplete, params);
+    }
+    /** Send `channels/typing` notification (best-effort). */
+    sendChannelsTyping(channelId) {
+        this.sendNotification(McplMethod.ChannelsTyping, { channelId });
+    }
+    // ==========================================================================
+    // Standard MCP methods
+    // ==========================================================================
+    /** Send `tools/list` and return the server's tool definitions. */
+    sendToolsList() {
+        return this.sendRequest('tools/list', {});
+    }
+    /** Send `tools/call` and return the result. Optionally includes state/checkpoint for stateful tools. */
+    sendToolsCall(name, args, stateParams) {
+        const params = { name, arguments: args };
+        if (stateParams?.state !== undefined)
+            params.state = stateParams.state;
+        if (stateParams?.checkpoint !== undefined)
+            params.checkpoint = stateParams.checkpoint;
+        return this.sendRequest('tools/call', params);
+    }
+    // ==========================================================================
+    // Lifecycle
+    // ==========================================================================
+    /** Close the connection: disable reconnect, kill the child process, and clean up resources. */
+    async close() {
+        // Disable reconnect before closing — explicit close means stop retrying
+        this.reconnectEnabled = false;
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        if (this.closed) {
+            return;
+        }
+        this.closed = true;
+        // Reject all pending requests
+        for (const [id, pending] of this.pendingRequests) {
+            pending.reject(new Error(`Connection to MCPL server "${this.id}" closed while awaiting response for ${pending.method} (id=${id})`));
+        }
+        this.pendingRequests.clear();
+        // Close readline
+        if (this.readline) {
+            this.readline.close();
+        }
+        // Kill the child process
+        if (this.process && !this.process.killed) {
+            this.process.kill();
+        }
+        // Wait for process to actually exit
+        if (this.process) {
+            await new Promise((resolve) => {
+                if (this.process.exitCode !== null || this.process.killed) {
+                    resolve();
+                }
+                else {
+                    this.process.once('exit', () => resolve());
+                }
+            });
+        }
+        this.emit('close');
+    }
+    /**
+     * Schedule a background reconnection attempt.
+     */
+    scheduleReconnect() {
+        if (!this.reconnectEnabled || this.reconnectTimer)
+            return;
+        this.reconnectTimer = setTimeout(() => {
+            this.reconnectTimer = null;
+            this.attemptReconnect();
+        }, this.reconnectIntervalMs);
+    }
+    /**
+     * Attempt to reconnect by spawning a new process and performing the handshake.
+     */
+    async attemptReconnect() {
+        if (!this.reconnectEnabled || !this.config || !this.hostCapabilities)
+            return;
+        try {
+            const fresh = await McplServerConnection.connect(this.config, this.hostCapabilities);
+            const internals = fresh.extractInternals();
+            // Transfer state from fresh connection to this instance
+            this.process = internals.process;
+            this.readline = internals.readline;
+            this.capabilities = fresh.capabilities;
+            this.closed = false;
+            this.nextRequestId = 1;
+            this.pendingRequests.clear();
+            // Re-wire message routing and lifecycle on the new process
+            this.setupMessageRouting();
+            this.setupLifecycle();
+            this.readyFlag = true; // Listeners already attached from initial wire
+            console.error(`MCPL server "${this.id}" reconnected successfully`);
+            this.emit('reconnect');
+        }
+        catch (error) {
+            console.error(`MCPL server "${this.id}" reconnect failed:`, error.message);
+            this.scheduleReconnect();
+        }
+    }
+    // ==========================================================================
+    // Private: message sending
+    // ==========================================================================
+    /**
+     * Send a JSON-RPC request and return a promise that resolves with the result
+     * or rejects with a JSON-RPC error.
+     */
+    sendRequest(method, params) {
+        if (this.closed) {
+            return Promise.reject(new Error(`Cannot send request: connection to "${this.id}" is closed`));
+        }
+        const id = this.nextRequestId++;
+        const request = {
+            jsonrpc: '2.0',
+            method,
+            id,
+            params,
+        };
+        return new Promise((resolve, reject) => {
+            this.pendingRequests.set(id, { resolve, reject, method });
+            this.process.stdin.write(JSON.stringify(request) + '\n');
+        });
+    }
+    /**
+     * Send a JSON-RPC notification (no `id`, no response expected).
+     */
+    sendNotification(method, params) {
+        if (this.closed) {
+            return;
+        }
+        const notification = {
+            jsonrpc: '2.0',
+            method,
+            params,
+        };
+        this.process.stdin.write(JSON.stringify(notification) + '\n');
+    }
+    // ==========================================================================
+    // Private: inbound message routing
+    // ==========================================================================
+    /**
+     * Map from JSON-RPC method name to the EventEmitter event name.
+     */
+    static METHOD_TO_EVENT = {
+        [McplMethod.PushEvent]: 'push-event',
+        [McplMethod.InferenceRequest]: 'inference-request',
+        [McplMethod.ScopeElevate]: 'scope-elevate',
+        [McplMethod.ChannelsRegister]: 'channels-register',
+        [McplMethod.ChannelsChanged]: 'channels-changed',
+        [McplMethod.ChannelsIncoming]: 'channels-incoming',
+        [McplMethod.FeatureSetsChanged]: 'feature-sets-changed',
+        'notifications/tools/list_changed': 'tools-list-changed',
+    };
+    /**
+     * Wire up readline to route incoming JSON-RPC messages.
+     */
+    setupMessageRouting() {
+        this.readline.on('line', (line) => {
+            let msg;
+            try {
+                msg = JSON.parse(line);
+            }
+            catch {
+                // Ignore non-JSON lines
+                return;
+            }
+            // Is this a response to one of our outbound requests?
+            if ('id' in msg && msg.id != null && !('method' in msg)) {
+                this.handleResponse(msg);
+                return;
+            }
+            // It is an inbound request or notification from the server
+            const request = msg;
+            const eventName = McplServerConnection.METHOD_TO_EVENT[request.method];
+            if (eventName) {
+                // Emit the typed event with params and (for requests) a respond callback
+                if (request.id != null) {
+                    // Server expects a response — provide a respond helper
+                    this.emit(eventName, request.params, {
+                        id: request.id,
+                        respond: (result) => this.sendResponse(request.id, result),
+                        respondError: (code, message, data) => this.sendErrorResponse(request.id, code, message, data),
+                    });
+                }
+                else {
+                    // Notification — no response expected
+                    this.emit(eventName, request.params);
+                }
+            }
+        });
+    }
+    /**
+     * Handle a JSON-RPC response by resolving/rejecting the corresponding pending request.
+     */
+    handleResponse(response) {
+        const pending = this.pendingRequests.get(response.id);
+        if (!pending) {
+            return; // Orphaned response — ignore
+        }
+        this.pendingRequests.delete(response.id);
+        if (response.error) {
+            pending.reject(new Error(`MCPL server "${this.id}" returned error for ${pending.method}: [${response.error.code}] ${response.error.message}`));
+        }
+        else {
+            pending.resolve(response.result);
+        }
+    }
+    /**
+     * Send a successful JSON-RPC response back to the server.
+     */
+    sendResponse(id, result) {
+        if (this.closed)
+            return;
+        const response = { jsonrpc: '2.0', id, result };
+        this.process.stdin.write(JSON.stringify(response) + '\n');
+    }
+    /**
+     * Send a JSON-RPC error response back to the server.
+     */
+    sendErrorResponse(id, code, message, data) {
+        if (this.closed)
+            return;
+        const response = {
+            jsonrpc: '2.0',
+            id,
+            error: { code, message, data },
+        };
+        this.process.stdin.write(JSON.stringify(response) + '\n');
+    }
+    // ==========================================================================
+    // Private: lifecycle
+    // ==========================================================================
+    /**
+     * Set up process error/exit handlers.
+     */
+    setupLifecycle() {
+        this.process.on('error', (err) => {
+            this.emit('error', new Error(`MCPL server "${this.id}" process error: ${err.message}`));
+        });
+        this.process.on('exit', (code, signal) => {
+            if (!this.closed) {
+                this.closed = true;
+                // Reject all pending requests
+                for (const [id, pending] of this.pendingRequests) {
+                    pending.reject(new Error(`MCPL server "${this.id}" exited unexpectedly (code=${code}, signal=${signal}) while awaiting ${pending.method} (id=${id})`));
+                }
+                this.pendingRequests.clear();
+                this.emit('close', code, signal);
+                // Schedule reconnect if enabled (unexpected exit triggers auto-reconnect)
+                if (this.reconnectEnabled) {
+                    this.scheduleReconnect();
+                }
+            }
+        });
+    }
+}
+//# sourceMappingURL=server-connection.js.map

package/dist/src/mcpl/server-connection.js.map

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

package/dist/src/mcpl/server-registry.d.ts

@@ -0,0 +1,63 @@
+/**
+ * McplServerRegistry — manages all connected MCPL server connections.
+ *
+ * Provides lookup by id, capability filtering, and feature set matching.
+ */
+import type { McplServerConfig, McplHostCapabilities } from './types.js';
+import { McplServerConnection } from './server-connection.js';
+/**
+ * Capability keys that can be queried via `getServersWithCapability`.
+ */
+export type McplCapabilityQuery = 'pushEvents' | 'contextHooks.beforeInference' | 'contextHooks.afterInference' | 'inferenceRequest' | 'modelInfo';
+/**
+ * Container that manages all connected MCPL servers.
+ *
+ * Provides methods to add/remove servers, look up by id, and query
+ * servers by advertised capabilities or feature set names.
+ */
+export declare class McplServerRegistry {
+    private servers;
+    /**
+     * Connect to an MCPL server and register it.
+     *
+     * Throws if a server with the same id is already registered, or if
+     * the connection/handshake fails.
+     */
+    addServer(config: McplServerConfig, hostCapabilities: McplHostCapabilities): Promise<McplServerConnection>;
+    /**
+     * Disconnect and remove a server by id.
+     *
+     * No-op if the server is not registered.
+     */
+    removeServer(id: string): Promise<void>;
+    /**
+     * Get a server connection by id, or null if not found.
+     */
+    getServer(id: string): McplServerConnection | null;
+    /**
+     * Get all currently connected servers.
+     */
+    getAllServers(): McplServerConnection[];
+    /**
+     * Get all servers that advertise a specific capability.
+     *
+     * Supported capability queries:
+     * - `'pushEvents'`                   — `capabilities.pushEvents === true`
+     * - `'contextHooks.beforeInference'`  — `capabilities.contextHooks?.beforeInference === true`
+     * - `'contextHooks.afterInference'`   — `capabilities.contextHooks?.afterInference` is truthy
+     * - `'inferenceRequest'`              — `capabilities.inferenceRequest` is truthy
+     * - `'modelInfo'`                     — `capabilities.modelInfo === true`
+     */
+    getServersWithCapability(cap: McplCapabilityQuery): McplServerConnection[];
+    /**
+     * Get all servers that declare a feature set with the given name.
+     *
+     * Checks `capabilities.featureSets` for a key matching `featureSet`.
+     */
+    getServersForFeatureSet(featureSet: string): McplServerConnection[];
+    /**
+     * Close all server connections and clear the registry.
+     */
+    closeAll(): Promise<void>;
+}
+//# sourceMappingURL=server-registry.d.ts.map

package/dist/src/mcpl/server-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-registry.d.ts","sourceRoot":"","sources":["../../../src/mcpl/server-registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAC3B,YAAY,GACZ,8BAA8B,GAC9B,6BAA6B,GAC7B,kBAAkB,GAClB,WAAW,CAAC;AAEhB;;;;;GAKG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,OAAO,CAA2C;IAE1D;;;;;OAKG;IACG,SAAS,CACb,MAAM,EAAE,gBAAgB,EACxB,gBAAgB,EAAE,oBAAoB,GACrC,OAAO,CAAC,oBAAoB,CAAC;IAyBhC;;;;OAIG;IACG,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS7C;;OAEG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI;IAIlD;;OAEG;IACH,aAAa,IAAI,oBAAoB,EAAE;IAIvC;;;;;;;;;OASG;IACH,wBAAwB,CAAC,GAAG,EAAE,mBAAmB,GAAG,oBAAoB,EAAE;IAsB1E;;;;OAIG;IACH,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,oBAAoB,EAAE;IAQnE;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAKhC"}