network-ai 5.10.2 → 5.12.0

package/dist/lib/mcp-transport-http.js

@@ -0,0 +1,528 @@
+"use strict";
+/**
+ * MCP Streamable HTTP Transport — 2025 MCP Spec
+ *
+ * Implements the MCP 2025-03-26 Streamable HTTP transport, which replaces
+ * the older SSE-only transport with a single bidirectional endpoint that
+ * supports both JSON responses and SSE streams from the same POST handler.
+ *
+ * Also adds full `resources/*` and `prompts/*` capability support through
+ * the `McpResourceProvider` and `McpPromptProvider` interfaces.
+ *
+ * Architecture:
+ *
+ *   POST /mcp   — single endpoint for all JSON-RPC 2.0 traffic
+ *                 • If Accept contains text/event-stream → SSE stream response
+ *                 • Otherwise → immediate JSON response
+ *   GET  /mcp   — optional SSE upgrade for server-initiated messages
+ *   GET  /health — health check
+ *   GET  /tools  — tool listing
+ *
+ * Zero external dependencies — uses Node.js `node:http` only.
+ *
+ * @module mcp-transport-http
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OrchestrationPromptProvider = exports.BlackboardResourceProvider = exports.McpStreamableServer = void 0;
+// Lazy-load http to avoid pulling in node:http unless this transport is used
+let _http;
+function requireHttp() {
+    if (!_http)
+        _http = require('node:http');
+    return _http;
+}
+// ============================================================================
+// STREAMABLE HTTP SERVER
+// ============================================================================
+/**
+ * MCP Streamable HTTP server implementing the 2025-03-26 MCP spec.
+ *
+ * Endpoints:
+ * - `POST /mcp`   — all JSON-RPC traffic; SSE-streamed if client sends
+ *                   `Accept: text/event-stream`
+ * - `GET  /mcp`   — server-initiated SSE stream (server push)
+ * - `GET  /health` — health check
+ * - `GET  /tools`  — tool listing JSON
+ *
+ * Register tool, resource, and prompt providers via the constructor or
+ * `registerResource()` / `registerPrompt()`.
+ *
+ * @example
+ * ```typescript
+ * import { McpStreamableServer } from 'network-ai';
+ *
+ * const bridge = new McpCombinedBridge('network-ai');
+ * bridge.register(new McpBlackboardBridgeAdapter(myBridge));
+ *
+ * const server = new McpStreamableServer(bridge, {
+ *   port: 3002,
+ *   secret: process.env['NETWORK_AI_MCP_SECRET']!,
+ * });
+ *
+ * server.registerResource(new BlackboardResourceProvider(myBridge));
+ * server.registerPrompt(new OrchestrationPromptProvider());
+ *
+ * await server.listen();
+ * ```
+ */
+class McpStreamableServer {
+    _bridge;
+    _opts;
+    _resourceProviders = [];
+    _promptProviders = [];
+    _server;
+    _sseClients = new Set();
+    constructor(bridge, options = {}) {
+        this._bridge = bridge;
+        this._opts = {
+            port: options.port ?? 3002,
+            host: options.host ?? '127.0.0.1',
+            secret: options.secret ?? '',
+            heartbeatMs: options.heartbeatMs ?? 15000,
+        };
+    }
+    /** Register an `McpResourceProvider`. */
+    registerResource(provider) {
+        this._resourceProviders.push(provider);
+    }
+    /** Register an `McpPromptProvider`. */
+    registerPrompt(provider) {
+        this._promptProviders.push(provider);
+    }
+    /** Start listening. Resolves when ready. */
+    listen() {
+        if (!this._opts.secret) {
+            return Promise.reject(new Error('McpStreamableServer requires a non-empty secret. ' +
+                'Set McpStreamableServerOptions.secret or NETWORK_AI_MCP_SECRET.'));
+        }
+        const isLoopback = this._opts.host === '127.0.0.1' ||
+            this._opts.host === 'localhost' ||
+            this._opts.host === '::1';
+        if (!isLoopback) {
+            process.stderr.write(`[network-ai] WARNING: McpStreamableServer binding to ${this._opts.host} ` +
+                '(non-loopback). Ensure your perimeter restricts access to this port.\n');
+        }
+        this._server = requireHttp().createServer((req, res) => this._handleRequest(req, res));
+        return new Promise(resolve => {
+            this._server.listen(this._opts.port, this._opts.host, () => resolve());
+        });
+    }
+    /** Stop the server and close all SSE streams. */
+    close() {
+        for (const client of this._sseClients) {
+            try {
+                client.end();
+            }
+            catch { /* ignore */ }
+        }
+        this._sseClients.clear();
+        return new Promise((resolve, reject) => {
+            this._server.close(err => (err ? reject(err) : resolve()));
+        });
+    }
+    get port() { return this._opts.port; }
+    get clientCount() { return this._sseClients.size; }
+    /** Broadcast an event to all connected SSE clients. */
+    broadcast(eventName, data) {
+        const msg = `event: ${eventName}\ndata: ${JSON.stringify(data)}\n\n`;
+        for (const client of this._sseClients) {
+            try {
+                client.write(msg);
+            }
+            catch { /* disconnected */ }
+        }
+    }
+    // --------------------------------------------------------------------------
+    // AUTH
+    // --------------------------------------------------------------------------
+    _isAuthorized(req) {
+        if (!this._opts.secret)
+            return false;
+        const authHeader = req.headers['authorization'];
+        if (typeof authHeader !== 'string')
+            return false;
+        const parts = authHeader.split(' ');
+        return parts[0]?.toLowerCase() === 'bearer' && parts[1] === this._opts.secret;
+    }
+    _unauthorized(res) {
+        res.writeHead(401, {
+            'Content-Type': 'application/json',
+            'WWW-Authenticate': 'Bearer realm="network-ai"',
+        });
+        res.end(JSON.stringify({ error: 'Unauthorized' }));
+    }
+    // --------------------------------------------------------------------------
+    // ROUTING
+    // --------------------------------------------------------------------------
+    _handleRequest(req, res) {
+        const base = `http://${req.headers.host ?? `localhost:${this._opts.port}`}`;
+        let parsed;
+        try {
+            parsed = new URL(req.url ?? '/', base);
+        }
+        catch {
+            res.writeHead(400);
+            res.end('Bad request');
+            return;
+        }
+        const origin = req.headers['origin'] ?? '';
+        const isLocalOrigin = /^https?:\/\/(localhost|127\.0\.0\.1)(:\d+)?$/.test(origin);
+        if (isLocalOrigin) {
+            res.setHeader('Access-Control-Allow-Origin', origin);
+            res.setHeader('Vary', 'Origin');
+        }
+        res.setHeader('Access-Control-Allow-Methods', 'GET, POST, OPTIONS');
+        res.setHeader('Access-Control-Allow-Headers', 'Content-Type, Authorization');
+        if (req.method === 'OPTIONS') {
+            res.writeHead(204);
+            res.end();
+            return;
+        }
+        const path = parsed.pathname;
+        if (req.method === 'POST' && (path === '/mcp' || path === '/')) {
+            if (!this._isAuthorized(req)) {
+                this._unauthorized(res);
+                return;
+            }
+            this._handlePost(req, res);
+        }
+        else if (req.method === 'GET' && (path === '/mcp' || path === '/')) {
+            if (!this._isAuthorized(req)) {
+                this._unauthorized(res);
+                return;
+            }
+            this._handleSseUpgrade(req, res);
+        }
+        else if (req.method === 'GET' && path === '/health') {
+            this._handleHealth(res);
+        }
+        else if (req.method === 'GET' && path === '/tools') {
+            this._handleTools(res);
+        }
+        else {
+            res.writeHead(404, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ error: 'Not found', endpoints: ['/mcp', '/health', '/tools'] }));
+        }
+    }
+    // --------------------------------------------------------------------------
+    // POST /mcp — main JSON-RPC handler (Streamable HTTP)
+    // --------------------------------------------------------------------------
+    _handlePost(req, res) {
+        const acceptsSse = (req.headers['accept'] ?? '').includes('text/event-stream');
+        let body = '';
+        const MAX_BODY = 4 * 1024 * 1024;
+        let bodySize = 0;
+        req.on('data', (chunk) => {
+            bodySize += chunk.length;
+            if (bodySize > MAX_BODY) {
+                res.writeHead(413, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ error: 'Request body too large' }));
+                req.destroy();
+                return;
+            }
+            body += chunk.toString();
+        });
+        req.on('end', async () => {
+            try {
+                const rpc = JSON.parse(body);
+                if (acceptsSse) {
+                    // Streamable HTTP: respond with SSE stream so the server can push
+                    // multiple messages (e.g. progress, then final result)
+                    res.writeHead(200, {
+                        'Content-Type': 'text/event-stream',
+                        'Cache-Control': 'no-cache',
+                        'Connection': 'keep-alive',
+                        'X-Accel-Buffering': 'no',
+                    });
+                    const response = await this._dispatch(rpc);
+                    res.write(`event: message\ndata: ${JSON.stringify(response)}\n\n`);
+                    res.end();
+                }
+                else {
+                    const response = await this._dispatch(rpc);
+                    res.writeHead(200, { 'Content-Type': 'application/json' });
+                    res.end(JSON.stringify(response));
+                }
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                const errResp = {
+                    jsonrpc: '2.0',
+                    id: null,
+                    error: { code: -32700 /* McpErrorCode.ParseError */, message: `Parse error: ${msg}` },
+                };
+                if (!res.headersSent) {
+                    res.writeHead(400, { 'Content-Type': 'application/json' });
+                }
+                res.end(JSON.stringify(errResp));
+            }
+        });
+        req.on('error', () => {
+            try {
+                if (!res.headersSent) {
+                    res.writeHead(500);
+                }
+                res.end();
+            }
+            catch { /* already sent */ }
+        });
+    }
+    // --------------------------------------------------------------------------
+    // GET /mcp — server-initiated SSE upgrade
+    // --------------------------------------------------------------------------
+    _handleSseUpgrade(req, res) {
+        res.writeHead(200, {
+            'Content-Type': 'text/event-stream',
+            'Cache-Control': 'no-cache',
+            'Connection': 'keep-alive',
+            'X-Accel-Buffering': 'no',
+        });
+        res.write(`event: endpoint\ndata: /mcp\n\n`);
+        this._sseClients.add(res);
+        let heartbeat = null;
+        if (this._opts.heartbeatMs > 0) {
+            heartbeat = setInterval(() => {
+                try {
+                    res.write(': heartbeat\n\n');
+                }
+                catch { /* closed */ }
+            }, this._opts.heartbeatMs);
+        }
+        req.on('close', () => {
+            if (heartbeat)
+                clearInterval(heartbeat);
+            this._sseClients.delete(res);
+        });
+    }
+    // --------------------------------------------------------------------------
+    // DISPATCH — routes JSON-RPC method including resources/* and prompts/*
+    // --------------------------------------------------------------------------
+    async _dispatch(rpc) {
+        if (!rpc || rpc.jsonrpc !== '2.0') {
+            return this._error(null, -32600 /* McpErrorCode.InvalidRequest */, 'Invalid JSON-RPC 2.0 request');
+        }
+        const { id, method } = rpc;
+        try {
+            switch (method) {
+                case 'initialize':
+                    return this._ok(id, {
+                        protocolVersion: '2025-03-26',
+                        capabilities: {
+                            tools: {},
+                            resources: { subscribe: false, listChanged: false },
+                            prompts: { listChanged: false },
+                        },
+                        serverInfo: { name: this._bridge.name ?? 'network-ai', version: '1.0.0' },
+                    });
+                case 'notifications/initialized':
+                    return this._ok(id, {});
+                // ── tools ────────────────────────────────────────────────────────────
+                case 'tools/list':
+                    return this._ok(id, { tools: this._bridge.allDefinitions() });
+                case 'tools/call': {
+                    const p = rpc.params;
+                    if (!p || typeof p !== 'object') {
+                        return this._error(id, -32602 /* McpErrorCode.InvalidParams */, 'tools/call requires params');
+                    }
+                    const toolName = p['name'];
+                    const toolArgs = (p['arguments'] ?? {});
+                    if (typeof toolName !== 'string' || !toolName) {
+                        return this._error(id, -32602 /* McpErrorCode.InvalidParams */, 'tools/call: "name" required');
+                    }
+                    // Route through the combined bridge
+                    const bridgeResp = await this._bridge.handleRPC({
+                        jsonrpc: '2.0', id, method: 'tools/call',
+                        params: { name: toolName, arguments: toolArgs },
+                    });
+                    return bridgeResp;
+                }
+                // ── resources ────────────────────────────────────────────────────────
+                case 'resources/list': {
+                    const resources = this._resourceProviders.flatMap(p => p.listResources());
+                    return this._ok(id, { resources });
+                }
+                case 'resources/read': {
+                    const p = rpc.params;
+                    const uri = p?.['uri'];
+                    if (typeof uri !== 'string') {
+                        return this._error(id, -32602 /* McpErrorCode.InvalidParams */, 'resources/read: "uri" required');
+                    }
+                    for (const provider of this._resourceProviders) {
+                        const content = await provider.readResource(uri);
+                        if (content !== null) {
+                            return this._ok(id, { contents: [content] });
+                        }
+                    }
+                    return this._error(id, -32602 /* McpErrorCode.InvalidParams */, `Resource not found: ${uri}`);
+                }
+                // ── prompts ──────────────────────────────────────────────────────────
+                case 'prompts/list': {
+                    const prompts = this._promptProviders.flatMap(p => p.listPrompts());
+                    return this._ok(id, { prompts });
+                }
+                case 'prompts/get': {
+                    const p = rpc.params;
+                    const name = p?.['name'];
+                    const args = (p?.['arguments'] ?? {});
+                    if (typeof name !== 'string') {
+                        return this._error(id, -32602 /* McpErrorCode.InvalidParams */, 'prompts/get: "name" required');
+                    }
+                    for (const provider of this._promptProviders) {
+                        const result = await provider.getPrompt(name, args);
+                        if (result !== null) {
+                            return this._ok(id, result);
+                        }
+                    }
+                    return this._error(id, -32602 /* McpErrorCode.InvalidParams */, `Prompt not found: ${name}`);
+                }
+                default:
+                    // Fall through to combined bridge for any unknown methods
+                    return this._bridge.handleRPC(rpc);
+            }
+        }
+        catch (err) {
+            return this._error(id, -32603 /* McpErrorCode.InternalError */, err instanceof Error ? err.message : String(err));
+        }
+    }
+    // --------------------------------------------------------------------------
+    // HELPERS
+    // --------------------------------------------------------------------------
+    _handleHealth(res) {
+        res.writeHead(200, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({
+            status: 'ok',
+            bridge: this._bridge.name ?? 'network-ai',
+            clients: this._sseClients.size,
+            protocolVersion: '2025-03-26',
+            capabilities: ['tools', 'resources', 'prompts'],
+            ts: new Date().toISOString(),
+        }));
+    }
+    _handleTools(res) {
+        const defs = this._bridge.allDefinitions();
+        res.writeHead(200, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ tools: defs, count: defs.length }));
+    }
+    _ok(id, result) {
+        return { jsonrpc: '2.0', id, result };
+    }
+    _error(id, code, message) {
+        return { jsonrpc: '2.0', id, error: { code, message } };
+    }
+}
+exports.McpStreamableServer = McpStreamableServer;
+// ============================================================================
+// BUILT-IN RESOURCE PROVIDER — Blackboard
+// ============================================================================
+/**
+ * Built-in `McpResourceProvider` that exposes blackboard entries as
+ * `network-ai://blackboard/<key>` URIs.
+ *
+ * Register with `McpStreamableServer.registerResource()`.
+ */
+class BlackboardResourceProvider {
+    _read;
+    _list;
+    /**
+     * @param read   Async function to read a blackboard key
+     * @param list   Async function to list all blackboard keys
+     */
+    constructor(read, list) {
+        this._read = read;
+        this._list = list;
+    }
+    listResources() {
+        // Static entry — dynamic keys are discoverable via resources/read with the URI
+        return [{
+                uri: 'network-ai://blackboard',
+                name: 'Blackboard',
+                mimeType: 'application/json',
+                description: 'Network-AI shared blackboard state. Read individual keys via network-ai://blackboard/<key>',
+            }];
+    }
+    async readResource(uri) {
+        if (!uri.startsWith('network-ai://blackboard'))
+            return null;
+        const key = uri.replace('network-ai://blackboard/', '').replace('network-ai://blackboard', '');
+        if (!key) {
+            // List all keys
+            const keys = await this._list();
+            return {
+                uri,
+                mimeType: 'application/json',
+                text: JSON.stringify({ keys }),
+            };
+        }
+        const value = await this._read(key);
+        return {
+            uri,
+            mimeType: 'application/json',
+            text: JSON.stringify({ key, value }),
+        };
+    }
+}
+exports.BlackboardResourceProvider = BlackboardResourceProvider;
+// ============================================================================
+// BUILT-IN PROMPT PROVIDER — Orchestration prompts
+// ============================================================================
+/**
+ * Built-in `McpPromptProvider` that exposes common Network-AI orchestration
+ * prompt templates to MCP clients.
+ */
+class OrchestrationPromptProvider {
+    listPrompts() {
+        return [
+            {
+                name: 'orchestrate',
+                description: 'Decompose a high-level goal into a multi-agent task plan using Network-AI',
+                arguments: [
+                    { name: 'goal', description: 'The high-level goal to accomplish', required: true },
+                    { name: 'agents', description: 'Comma-separated list of available agent IDs', required: false },
+                ],
+            },
+            {
+                name: 'audit_summary',
+                description: 'Summarise recent agent actions from the audit log',
+                arguments: [
+                    { name: 'limit', description: 'Maximum number of recent entries (default: 20)', required: false },
+                ],
+            },
+        ];
+    }
+    async getPrompt(name, args) {
+        switch (name) {
+            case 'orchestrate': {
+                const goal = args['goal'] ?? '(no goal specified)';
+                const agents = args['agents'] ? `\n\nAvailable agents: ${args['agents']}` : '';
+                return {
+                    description: 'Multi-agent orchestration plan',
+                    messages: [{
+                            role: 'user',
+                            content: {
+                                type: 'text',
+                                text: `You are a Network-AI orchestrator. Decompose the following goal into a parallel task DAG using the available blackboard tools and agent adapters.${agents}\n\nGoal: ${goal}\n\nFor each task: (1) assign an agent, (2) list dependencies, (3) define the success condition.`,
+                            },
+                        }],
+                };
+            }
+            case 'audit_summary': {
+                const limit = parseInt(args['limit'] ?? '20', 10);
+                return {
+                    description: 'Audit log summary prompt',
+                    messages: [{
+                            role: 'user',
+                            content: {
+                                type: 'text',
+                                text: `Summarise the last ${limit} entries from the Network-AI audit log. Group by agent, highlight any permission denials, trust violations, or UNSUPPORTED_CLAIM events. Format as a concise bullet list.`,
+                            },
+                        }],
+                };
+            }
+            default:
+                return null;
+        }
+    }
+}
+exports.OrchestrationPromptProvider = OrchestrationPromptProvider;
+//# sourceMappingURL=mcp-transport-http.js.map

package/dist/lib/mcp-transport-http.js.map

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

package/dist/lib/phase-pipeline.d.ts

@@ -133,6 +133,14 @@ export interface PhasePipelineOptions {
      * summarises the history whenever the threshold is breached.
      */
     compaction?: CompactionOptions;
+    /**
+     * Path to a JSON checkpoint file for durable DAG execution.
+     * When set, the pipeline saves a checkpoint after every completed phase.
+     * On restart, if the file exists, already-completed phases are skipped and
+     * execution resumes from the first non-completed phase.
+     * Use `PhasePipeline.clearCheckpoint(path)` to delete after a successful run.
+     */
+    checkpointPath?: string;
 }
 /**
  * Runtime context available during pipeline execution.
@@ -200,6 +208,29 @@ export declare class PhasePipeline {
      * Reset the pipeline for re-execution.
      */
     reset(): void;
+    /**
+     * Save the current pipeline state to the checkpoint file.
+     * Called automatically after each phase when `checkpointPath` is set.
+     * @internal
+     */
+    private _saveCheckpoint;
+    /**
+     * Load a checkpoint from disk and restore phase results + next phase index.
+     * Returns the index of the next phase to run (0 if no checkpoint).
+     * @internal
+     */
+    private _loadCheckpoint;
+    /**
+     * Delete the checkpoint file for this pipeline (or any given path).
+     * Call this after a successful pipeline run to clean up.
+     *
+     * @example
+     * ```typescript
+     * const result = await pipeline.run();
+     * if (result.success) PhasePipeline.clearCheckpoint('./data/my-pipeline.checkpoint.json');
+     * ```
+     */
+    static clearCheckpoint(checkpointPath: string): void;
     /** @internal */
     private _maybeCompact;
     private buildPayload;

package/dist/lib/phase-pipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"phase-pipeline.d.ts","sourceRoot":"","sources":["../../lib/phase-pipeline.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"phase-pipeline.d.ts","sourceRoot":"","sources":["../../lib/phase-pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACtF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAQpE,0CAA0C;AAC1C,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,mBAAmB,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;AAErI;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,0EAA0E;IAC1E,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wEAAwE;IACxE,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,WAAW,EAAE,KAAK,YAAY,CAAC;IACnF,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB;IACnB,MAAM,EAAE,WAAW,CAAC;IACpB,sCAAsC;IACtC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACvC,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,QAAQ,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CACxE;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,yDAAyD;IACzD,OAAO,EAAE,OAAO,CAAC;IACjB,wBAAwB;IACxB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAC7B,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,WAAW,EACxB,eAAe,EAAE,wBAAwB,KACtC,OAAO,CAAC;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAE1E;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,SAAS,EAAE,CAAC,eAAe,EAAE,WAAW,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/D;;;;;;;;;OASG;IACH,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,cAAc,EAAE,aAAa,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;CAC5G;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,wCAAwC;IACxC,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,4CAA4C;IAC5C,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oCAAoC;IACpC,YAAY,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1D,uCAAuC;IACvC,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/D,2DAA2D;IAC3D,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;OAIG;IACH,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,+CAA+C;IAC/C,eAAe,EAAE,WAAW,EAAE,CAAC;IAC/B,iCAAiC;IACjC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;CACrB;AA2BD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,WAAW,CAAe;IAClC,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,OAAO,CAAoE;IACnF,0DAA0D;IAC1D,OAAO,CAAC,gBAAgB,CAAK;IAC7B,+DAA+D;IAC/D,OAAO,CAAC,sBAAsB,CAAuB;gBAEzC,QAAQ,EAAE,eAAe,EAAE,WAAW,EAAE,YAAY,EAAE,OAAO,EAAE,oBAAoB;IAgB/F,8BAA8B;IAC9B,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,sEAAsE;IACtE,IAAI,OAAO,IAAI,aAAa,CAAC,WAAW,CAAC,CAExC;IAED,wBAAwB;IACxB,IAAI,MAAM,IAAI,aAAa,CAAC,eAAe,CAAC,CAE3C;IAED;;;;;;;;OAQG;IACG,GAAG,CAAC,cAAc,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC;IA4IjE,mFAAmF;IACnF,IAAI,qBAAqB,IAAI,MAAM,GAAG,IAAI,CAEzC;IAED,gEAAgE;IAChE,IAAI,eAAe,IAAI,MAAM,CAE5B;IAED;;OAEG;IACH,KAAK,IAAI,IAAI;IAWb;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAyBvB;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAsBvB;;;;;;;;;OASG;IACH,MAAM,CAAC,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI;IAcpD,gBAAgB;YACF,aAAa;IAoC3B,OAAO,CAAC,YAAY;YAON,kBAAkB;CAYjC"}