network-ai 5.10.2 → 5.12.0

package/dist/esm/adapters/langgraph-adapter.js

@@ -0,0 +1,119 @@
+"use strict";
+/**
+ * LangGraph Adapter
+ *
+ * Integrates LangGraph (LangChain's stateful graph execution framework)
+ * with the SwarmOrchestrator.
+ *
+ * LangGraph models agent workflows as directed graphs with typed state,
+ * conditional edges, and cycles. This adapter wraps user-supplied graph
+ * instances with no hard dependency on the LangGraph package.
+ *
+ * Usage:
+ *   const adapter = new LangGraphAdapter();
+ *   adapter.registerGraph('research-flow', myCompiledGraph, {
+ *     inputKey: 'messages',
+ *     outputKey: 'response',
+ *   });
+ *
+ * @module LangGraphAdapter
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LangGraphAdapter = void 0;
+const base_adapter_1 = require("./base-adapter");
+// ---------------------------------------------------------------------------
+// Adapter
+// ---------------------------------------------------------------------------
+/**
+ * Adapter for LangGraph stateful agent graphs.
+ *
+ * Each registered graph is exposed as a named agent. The adapter
+ * handles input mapping, timeout enforcement, and result extraction.
+ */
+class LangGraphAdapter extends base_adapter_1.BaseAdapter {
+    name = 'langgraph';
+    version = '1.0.0';
+    graphs = new Map();
+    get capabilities() {
+        return {
+            streaming: false,
+            parallel: true,
+            bidirectional: false,
+            discovery: true,
+            authentication: false,
+            statefulSessions: true,
+        };
+    }
+    // -----------------------------------------------------------------------
+    // Graph registration
+    // -----------------------------------------------------------------------
+    /**
+     * Register a compiled LangGraph as a named agent.
+     */
+    registerGraph(agentId, graph, options = {}) {
+        const config = { graph, ...options };
+        this.graphs.set(agentId, config);
+        this.registerLocalAgent({
+            id: agentId,
+            name: agentId,
+            status: 'available',
+            capabilities: ['graph', 'stateful'],
+            metadata: { adapter: 'langgraph', inputKey: config.inputKey ?? 'messages' },
+        });
+    }
+    // -----------------------------------------------------------------------
+    // Execution
+    // -----------------------------------------------------------------------
+    async executeAgent(agentId, payload, _context) {
+        this.ensureReady();
+        const config = this.graphs.get(agentId);
+        if (!config) {
+            return this.errorResult('LANGGRAPH_AGENT_NOT_FOUND', `No graph registered for agent '${agentId}'`);
+        }
+        const inputKey = config.inputKey ?? 'messages';
+        const outputKey = config.outputKey ?? 'response';
+        const timeoutMs = config.timeoutMs ?? 60_000;
+        // Build input state
+        const input = {
+            [inputKey]: payload.params ?? payload.action,
+            ...payload.handoff?.context,
+        };
+        // Build runnable config
+        const runnableConfig = {
+            ...config.runnableConfig,
+        };
+        if (config.threadId) {
+            runnableConfig['configurable'] = {
+                ...runnableConfig['configurable'],
+                thread_id: config.threadId,
+            };
+        }
+        const start = Date.now();
+        try {
+            const result = await Promise.race([
+                config.graph.invoke(input, runnableConfig),
+                new Promise((_, reject) => setTimeout(() => reject(new Error('LangGraph invocation timed out')), timeoutMs)),
+            ]);
+            const durationMs = Date.now() - start;
+            const output = result[outputKey] ?? result;
+            return this.successResult({
+                output,
+                state: result,
+                graphAgent: agentId,
+            }, durationMs);
+        }
+        catch (err) {
+            return this.errorResult('LANGGRAPH_EXECUTION_FAILED', err instanceof Error ? err.message : String(err));
+        }
+    }
+    // -----------------------------------------------------------------------
+    // Lifecycle
+    // -----------------------------------------------------------------------
+    async shutdown() {
+        this.graphs.clear();
+        await super.shutdown();
+    }
+}
+exports.LangGraphAdapter = LangGraphAdapter;
+//# sourceMappingURL=langgraph-adapter.js.map

package/dist/esm/adapters/langgraph-adapter.js.map

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

package/dist/esm/adapters/llamaindex-adapter.js

@@ -0,0 +1,135 @@
+"use strict";
+/**
+ * LlamaIndex Adapter
+ *
+ * Integrates LlamaIndex agents (QueryEngine, ChatEngine, AgentRunner)
+ * with the SwarmOrchestrator. LlamaIndex specialises in retrieval-augmented
+ * generation (RAG) and agent-based reasoning over data.
+ *
+ * Usage:
+ *   const adapter = new LlamaIndexAdapter();
+ *   adapter.registerQueryEngine("rag-search", myQueryEngine);
+ *   adapter.registerChatEngine("assistant", myChatEngine);
+ *   adapter.registerAgentRunner("researcher", myAgentRunner);
+ *   await registry.addAdapter(adapter);
+ *
+ * Then in the orchestrator:
+ *   delegateTask({ targetAgent: "llamaindex:rag-search", ... })
+ *
+ * @module LlamaIndexAdapter
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LlamaIndexAdapter = void 0;
+const base_adapter_1 = require("./base-adapter");
+class LlamaIndexAdapter extends base_adapter_1.BaseAdapter {
+    name = 'llamaindex';
+    version = '1.0.0';
+    engines = new Map();
+    get capabilities() {
+        return {
+            streaming: true,
+            parallel: true,
+            bidirectional: false,
+            discovery: true,
+            authentication: false,
+            statefulSessions: true,
+        };
+    }
+    // --- Registration ---
+    registerQueryEngine(agentId, engine, metadata) {
+        this.engines.set(agentId, { type: 'query', engine });
+        this.registerLocalAgent({
+            id: agentId,
+            name: agentId,
+            description: metadata?.description ?? `LlamaIndex QueryEngine: ${agentId}`,
+            capabilities: metadata?.capabilities ?? ['query', 'rag'],
+            status: 'available',
+        });
+    }
+    registerChatEngine(agentId, engine, metadata) {
+        this.engines.set(agentId, { type: 'chat', engine });
+        this.registerLocalAgent({
+            id: agentId,
+            name: agentId,
+            description: metadata?.description ?? `LlamaIndex ChatEngine: ${agentId}`,
+            capabilities: metadata?.capabilities ?? ['chat', 'rag'],
+            status: 'available',
+        });
+    }
+    registerAgentRunner(agentId, engine, metadata) {
+        this.engines.set(agentId, { type: 'agent', engine });
+        this.registerLocalAgent({
+            id: agentId,
+            name: agentId,
+            description: metadata?.description ?? `LlamaIndex AgentRunner: ${agentId}`,
+            capabilities: metadata?.capabilities ?? ['agent', 'reasoning', 'tools'],
+            status: 'available',
+        });
+    }
+    // --- Execution ---
+    async executeAgent(agentId, payload, context) {
+        this.ensureReady();
+        const entry = this.engines.get(agentId);
+        if (!entry) {
+            return this.errorResult('AGENT_NOT_FOUND', `LlamaIndex engine "${agentId}" is not registered`, false);
+        }
+        const query = this.extractQuery(payload);
+        const startTime = Date.now();
+        try {
+            switch (entry.type) {
+                case 'query':
+                    return await this.executeQuery(entry.engine, query, startTime);
+                case 'chat':
+                    return await this.executeChat(entry.engine, query, payload, startTime);
+                case 'agent':
+                    return await this.executeAgentRunner(entry.engine, query, startTime);
+                default:
+                    return this.errorResult('UNKNOWN_TYPE', 'Unknown engine type', false);
+            }
+        }
+        catch (error) {
+            return this.errorResult('LLAMAINDEX_ERROR', error instanceof Error ? error.message : 'LlamaIndex execution failed', true, error);
+        }
+    }
+    // --- Private helpers ---
+    extractQuery(payload) {
+        if (payload.handoff?.instruction)
+            return payload.handoff.instruction;
+        if (payload.params?.query)
+            return String(payload.params.query);
+        if (payload.params?.message)
+            return String(payload.params.message);
+        return JSON.stringify(payload.params);
+    }
+    async executeQuery(engine, query, startTime) {
+        const response = await engine.query(query);
+        return this.successResult(this.normalizeResponse(response), Date.now() - startTime);
+    }
+    async executeChat(engine, message, payload, startTime) {
+        const history = payload.params?.chatHistory;
+        const response = await engine.chat(message, history);
+        return this.successResult(this.normalizeResponse(response), Date.now() - startTime);
+    }
+    async executeAgentRunner(engine, message, startTime) {
+        const response = await engine.chat(message);
+        return this.successResult(this.normalizeResponse(response), Date.now() - startTime);
+    }
+    normalizeResponse(response) {
+        const text = response.response ?? response.toString?.() ?? '';
+        const result = { response: text };
+        if (response.sourceNodes?.length) {
+            result.sources = response.sourceNodes.map((sn) => ({
+                text: sn.node?.text?.slice(0, 200),
+                score: sn.score,
+                metadata: sn.node?.metadata,
+            }));
+        }
+        if (response.metadata) {
+            result.metadata = response.metadata;
+        }
+        return result;
+    }
+}
+exports.LlamaIndexAdapter = LlamaIndexAdapter;
+//# sourceMappingURL=llamaindex-adapter.js.map

package/dist/esm/adapters/llamaindex-adapter.js.map

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

package/dist/esm/adapters/mcp-adapter.js

@@ -0,0 +1,200 @@
+"use strict";
+/**
+ * MCP (Model Context Protocol) Adapter
+ *
+ * Connects the SwarmOrchestrator to MCP servers, enabling agent communication
+ * over the Model Context Protocol. This enables cross-network agent discovery
+ * and execution via MCP's tool-calling interface.
+ *
+ * MCP servers expose "tools" — this adapter maps each tool to an agent
+ * that the orchestrator can delegate tasks to.
+ *
+ * Usage:
+ *   const adapter = new MCPAdapter();
+ *   await registry.addAdapter(adapter, {
+ *     connection: { url: 'http://localhost:3000/mcp' }
+ *   });
+ *
+ * Or with pre-registered tool functions:
+ *   const adapter = new MCPAdapter();
+ *   adapter.registerTool("search", searchFunction);
+ *   await registry.addAdapter(adapter);
+ *
+ * Then in the orchestrator:
+ *   delegateTask({ targetAgent: "mcp:search", ... })
+ *
+ * @module MCPAdapter
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MCPAdapter = void 0;
+const base_adapter_1 = require("./base-adapter");
+class MCPAdapter extends base_adapter_1.BaseAdapter {
+    name = 'mcp';
+    version = '1.0.0';
+    tools = new Map();
+    toolMetadata = new Map();
+    serverConnection = null;
+    get capabilities() {
+        return {
+            streaming: true,
+            parallel: true,
+            bidirectional: false,
+            discovery: true,
+            authentication: true,
+            statefulSessions: false,
+        };
+    }
+    async initialize(config) {
+        await super.initialize(config);
+        // If a server connection factory is provided, use it
+        if (config.options?.serverConnection) {
+            this.serverConnection = config.options.serverConnection;
+            // Discover tools from the server
+            await this.discoverServerTools();
+        }
+        // If a URL is provided, the user needs to set up the connection themselves
+        // (We don't bundle an MCP client library — keep it dependency-free)
+        if (config.connection?.url && !this.serverConnection) {
+            console.info(`[MCPAdapter] URL configured: ${config.connection.url}. ` +
+                `Provide a serverConnection via config.options.serverConnection or register tools manually.`);
+        }
+        this.ready = true;
+    }
+    /**
+     * Register a local tool handler (no MCP server needed)
+     */
+    registerTool(name, handler, metadata) {
+        this.tools.set(name, handler);
+        this.toolMetadata.set(name, {
+            name,
+            description: metadata?.description,
+            inputSchema: metadata?.inputSchema,
+        });
+        this.registerLocalAgent({
+            id: name,
+            name,
+            description: metadata?.description ?? `MCP tool: ${name}`,
+            capabilities: ['tool'],
+            status: 'available',
+        });
+    }
+    async discoverServerTools() {
+        if (!this.serverConnection)
+            return;
+        try {
+            const tools = await this.serverConnection.listTools();
+            for (const tool of tools) {
+                this.toolMetadata.set(tool.name, tool);
+                this.registerLocalAgent({
+                    id: tool.name,
+                    name: tool.name,
+                    description: tool.description ?? `MCP server tool: ${tool.name}`,
+                    capabilities: ['tool'],
+                    status: 'available',
+                    metadata: { inputSchema: tool.inputSchema },
+                });
+            }
+        }
+        catch (error) {
+            console.error('[MCPAdapter] Failed to discover server tools:', error);
+        }
+    }
+    async executeAgent(agentId, payload, context) {
+        this.ensureReady();
+        const startTime = Date.now();
+        // Strategy 1: Local tool handler
+        const localHandler = this.tools.get(agentId);
+        if (localHandler) {
+            return this.executeLocalTool(agentId, localHandler, payload, startTime);
+        }
+        // Strategy 2: Remote MCP server
+        if (this.serverConnection) {
+            return this.executeRemoteTool(agentId, payload, startTime);
+        }
+        return this.errorResult('TOOL_NOT_FOUND', `MCP tool "${agentId}" not found locally or on any connected server`, false);
+    }
+    async executeLocalTool(name, handler, payload, startTime) {
+        try {
+            const args = this.buildToolArgs(payload);
+            const result = await handler(args);
+            if (result.isError) {
+                const errorText = result.content
+                    .filter(c => c.type === 'text')
+                    .map(c => c.text)
+                    .join('\n');
+                return this.errorResult('TOOL_ERROR', errorText || 'Tool returned an error', true);
+            }
+            // Extract text content from MCP response format
+            const data = this.extractContent(result.content);
+            return this.successResult(data, Date.now() - startTime);
+        }
+        catch (error) {
+            return this.errorResult('MCP_ERROR', error instanceof Error ? error.message : 'MCP tool execution failed', true, error);
+        }
+    }
+    async executeRemoteTool(name, payload, startTime) {
+        if (!this.serverConnection) {
+            return this.errorResult('NO_CONNECTION', 'No MCP server connection', false);
+        }
+        try {
+            const args = this.buildToolArgs(payload);
+            const result = await this.serverConnection.callTool(name, args);
+            if (result.isError) {
+                const errorText = result.content
+                    .filter(c => c.type === 'text')
+                    .map(c => c.text)
+                    .join('\n');
+                return this.errorResult('TOOL_ERROR', errorText || 'Remote tool returned an error', true);
+            }
+            const data = this.extractContent(result.content);
+            return this.successResult(data, Date.now() - startTime);
+        }
+        catch (error) {
+            return this.errorResult('MCP_REMOTE_ERROR', error instanceof Error ? error.message : 'Remote MCP tool call failed', true, error);
+        }
+    }
+    buildToolArgs(payload) {
+        const args = { ...payload.params };
+        if (payload.handoff) {
+            args.instruction = payload.handoff.instruction;
+            if (payload.handoff.context) {
+                args.context = payload.handoff.context;
+            }
+        }
+        return args;
+    }
+    extractContent(content) {
+        if (content.length === 1) {
+            if (content[0].type === 'text' && content[0].text) {
+                // Try to parse as JSON
+                try {
+                    return JSON.parse(content[0].text);
+                }
+                catch {
+                    return content[0].text;
+                }
+            }
+            return content[0].data ?? content[0].text;
+        }
+        // Multiple content blocks — return structured
+        return content.map(c => ({
+            type: c.type,
+            value: c.type === 'text' ? c.text : c.data,
+        }));
+    }
+    async shutdown() {
+        if (this.serverConnection) {
+            try {
+                await this.serverConnection.close();
+            }
+            catch {
+                // Best-effort
+            }
+            this.serverConnection = null;
+        }
+        await super.shutdown();
+    }
+}
+exports.MCPAdapter = MCPAdapter;
+//# sourceMappingURL=mcp-adapter.js.map

package/dist/esm/adapters/mcp-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-adapter.js","sourceRoot":"","sources":["../../../adapters/mcp-adapter.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;;;AAEH,iDAA6C;AAwC7C,MAAa,UAAW,SAAQ,0BAAW;IAChC,IAAI,GAAG,KAAK,CAAC;IACb,OAAO,GAAG,OAAO,CAAC;IACnB,KAAK,GAAgC,IAAI,GAAG,EAAE,CAAC;IAC/C,YAAY,GAAyB,IAAI,GAAG,EAAE,CAAC;IAC/C,gBAAgB,GAA+B,IAAI,CAAC;IAE5D,IAAI,YAAY;QACd,OAAO;YACL,SAAS,EAAE,IAAI;YACf,QAAQ,EAAE,IAAI;YACd,aAAa,EAAE,KAAK;YACpB,SAAS,EAAE,IAAI;YACf,cAAc,EAAE,IAAI;YACpB,gBAAgB,EAAE,KAAK;SACxB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAqB;QACpC,MAAM,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAE/B,qDAAqD;QACrD,IAAI,MAAM,CAAC,OAAO,EAAE,gBAAgB,EAAE,CAAC;YACrC,IAAI,CAAC,gBAAgB,GAAG,MAAM,CAAC,OAAO,CAAC,gBAAuC,CAAC;YAC/E,iCAAiC;YACjC,MAAM,IAAI,CAAC,mBAAmB,EAAE,CAAC;QACnC,CAAC;QAED,2EAA2E;QAC3E,oEAAoE;QACpE,IAAI,MAAM,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACrD,OAAO,CAAC,IAAI,CACV,gCAAgC,MAAM,CAAC,UAAU,CAAC,GAAG,IAAI;gBACzD,4FAA4F,CAC7F,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAED;;OAEG;IACH,YAAY,CACV,IAAY,EACZ,OAAuB,EACvB,QAA0E;QAE1E,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC9B,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE;YAC1B,IAAI;YACJ,WAAW,EAAE,QAAQ,EAAE,WAAW;YAClC,WAAW,EAAE,QAAQ,EAAE,WAAW;SACnC,CAAC,CAAC;QACH,IAAI,CAAC,kBAAkB,CAAC;YACtB,EAAE,EAAE,IAAI;YACR,IAAI;YACJ,WAAW,EAAE,QAAQ,EAAE,WAAW,IAAI,aAAa,IAAI,EAAE;YACzD,YAAY,EAAE,CAAC,MAAM,CAAC;YACtB,MAAM,EAAE,WAAW;SACpB,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,mBAAmB;QAC/B,IAAI,CAAC,IAAI,CAAC,gBAAgB;YAAE,OAAO;QAEnC,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,SAAS,EAAE,CAAC;YACtD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;gBACvC,IAAI,CAAC,kBAAkB,CAAC;oBACtB,EAAE,EAAE,IAAI,CAAC,IAAI;oBACb,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,oBAAoB,IAAI,CAAC,IAAI,EAAE;oBAChE,YAAY,EAAE,CAAC,MAAM,CAAC;oBACtB,MAAM,EAAE,WAAW;oBACnB,QAAQ,EAAE,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE;iBAC5C,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,+CAA+C,EAAE,KAAK,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,OAAe,EACf,OAAqB,EACrB,OAAqB;QAErB,IAAI,CAAC,WAAW,EAAE,CAAC;QAEnB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,iCAAiC;QACjC,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC7C,IAAI,YAAY,EAAE,CAAC;YACjB,OAAO,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;QAC1E,CAAC;QAED,gCAAgC;QAChC,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC1B,OAAO,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;QAC7D,CAAC;QAED,OAAO,IAAI,CAAC,WAAW,CACrB,gBAAgB,EAChB,aAAa,OAAO,gDAAgD,EACpE,KAAK,CACN,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAC5B,IAAY,EACZ,OAAuB,EACvB,OAAqB,EACrB,SAAiB;QAEjB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YACzC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;YAEnC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO;qBAC7B,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC;qBAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;qBAChB,IAAI,CAAC,IAAI,CAAC,CAAC;gBACd,OAAO,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE,SAAS,IAAI,wBAAwB,EAAE,IAAI,CAAC,CAAC;YACrF,CAAC;YAED,gDAAgD;YAChD,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACjD,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,CAAC;QAC1D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,WAAW,CACrB,WAAW,EACX,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,2BAA2B,EACpE,IAAI,EACJ,KAAK,CACN,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,iBAAiB,CAC7B,IAAY,EACZ,OAAqB,EACrB,SAAiB;QAEjB,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAC,WAAW,CAAC,eAAe,EAAE,0BAA0B,EAAE,KAAK,CAAC,CAAC;QAC9E,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YACzC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAEhE,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO;qBAC7B,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC;qBAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;qBAChB,IAAI,CAAC,IAAI,CAAC,CAAC;gBACd,OAAO,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE,SAAS,IAAI,+BAA+B,EAAE,IAAI,CAAC,CAAC;YAC5F,CAAC;YAED,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACjD,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,CAAC;QAC1D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,WAAW,CACrB,kBAAkB,EAClB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,6BAA6B,EACtE,IAAI,EACJ,KAAK,CACN,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,aAAa,CAAC,OAAqB;QACzC,MAAM,IAAI,GAA4B,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;QAE5D,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC;YAC/C,IAAI,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;gBAC5B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;YACzC,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,cAAc,CAAC,OAA+D;QACpF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;gBAClD,uBAAuB;gBACvB,IAAI,CAAC;oBACH,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBACrC,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;gBACzB,CAAC;YACH,CAAC;YACD,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC5C,CAAC;QAED,8CAA8C;QAC9C,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACvB,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,KAAK,EAAE,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI;SAC3C,CAAC,CAAC,CAAC;IACN,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC1B,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC;YACtC,CAAC;YAAC,MAAM,CAAC;gBACP,cAAc;YAChB,CAAC;YACD,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;QAC/B,CAAC;QACD,MAAM,KAAK,CAAC,QAAQ,EAAE,CAAC;IACzB,CAAC;CACF;AA3ND,gCA2NC"}