@siglo/monitor 0.0.0-stage → 1.0.0

package/dist/store.js

@@ -0,0 +1,173 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkflowExecutionStore = void 0;
+const wait_state_1 = require("./wait-state");
+const core_1 = require("@siglo/core");
+class WorkflowExecutionStore {
+    runs = new Map();
+    maxRuns;
+    maxEventsPerRun;
+    maxDiffsPerRun;
+    redaction;
+    constructor(maxRuns = 1000, maxEventsPerRun = 500, maxDiffsPerRun = 200, redaction) {
+        this.redaction = redaction;
+        this.maxRuns = maxRuns;
+        this.maxEventsPerRun = maxEventsPerRun;
+        this.maxDiffsPerRun = maxDiffsPerRun;
+    }
+    addEvent(event) {
+        if (event)
+            event = (0, core_1.redactEvent)(event, this.redaction);
+        if (!event || !event.stackId) {
+            return;
+        }
+        let run = this.runs.get(event.stackId);
+        if (!run) {
+            run = {
+                stackId: event.stackId,
+                namespace: event.namespace,
+                status: 'RUNNING',
+                startTime: event.timestamp || Date.now(),
+                steps: {},
+                context: {},
+                contextDiffs: [],
+                events: []
+            };
+            this.runs.set(event.stackId, run);
+            // Evict oldest if exceeding capacity
+            if (this.runs.size > this.maxRuns) {
+                const oldestKey = this.runs.keys().next().value;
+                if (oldestKey) {
+                    this.runs.delete(oldestKey);
+                }
+            }
+        }
+        run.events.push(event);
+        if (run.events.length > this.maxEventsPerRun) {
+            run.events.splice(1, run.events.length - this.maxEventsPerRun);
+        }
+        switch (event.type) {
+            case 'step:inspection':
+            case 'ai:complete': {
+                const data = (0, core_1.sanitizeInspection)(event.inspection);
+                if (data) {
+                    const step = this.getOrCreateStep(run, event.stepId, event.stepName);
+                    step.inspections = [...(step.inspections || []), {
+                            attempt: event.attempt || step.attempts, timestamp: event.timestamp, data
+                        }].slice(-50);
+                }
+                break;
+            }
+            case 'flow:start':
+                run.flowName = event.flowName || run.flowName;
+                run.version = event.version || run.version;
+                run.ast = event.ast || run.ast;
+                run.namespace = event.namespace || run.namespace;
+                run.startTime = event.timestamp || run.startTime;
+                run.status = 'RUNNING';
+                break;
+            case 'step:start': {
+                const step = this.getOrCreateStep(run, event.stepId, event.stepName);
+                step.status = 'RUNNING';
+                step.attempts = event.attempt || 1;
+                step.startTime = event.timestamp;
+                break;
+            }
+            case 'step:complete': {
+                const step = this.getOrCreateStep(run, event.stepId, event.stepName);
+                step.status = 'COMPLETED';
+                step.durationMs = event.durationMs;
+                step.outputSummary = event.outputSummary;
+                step.endTime = event.timestamp;
+                break;
+            }
+            case 'step:retry': {
+                const step = this.getOrCreateStep(run, event.stepId, event.stepName || 'step');
+                step.status = 'RETRYING';
+                step.attempts = event.attempt;
+                step.maxAttempts = event.maxAttempts;
+                step.error = event.error;
+                break;
+            }
+            case 'step:error': {
+                const step = this.getOrCreateStep(run, event.stepId, event.stepName);
+                step.status = 'FAILED';
+                step.error = event.error;
+                break;
+            }
+            case 'step:skipped': {
+                const step = this.getOrCreateStep(run, event.stepId, event.stepName);
+                step.status = 'SKIPPED';
+                break;
+            }
+            case 'context:change': {
+                run.context[event.field] = event.value;
+                const diff = {
+                    stepId: event.stepId,
+                    field: event.field,
+                    value: event.value,
+                    timestamp: event.timestamp
+                };
+                run.contextDiffs.push(diff);
+                if (run.contextDiffs.length > this.maxDiffsPerRun) {
+                    run.contextDiffs.shift();
+                }
+                break;
+            }
+            case 'flow:suspended': {
+                run.status = 'SUSPENDED';
+                run.waitingForEvent = event.waitingForEvent;
+                run.steps = (0, wait_state_1.applyWaitEvent)(run.steps, event);
+                break;
+            }
+            case 'flow:resumed': {
+                run.status = 'RUNNING';
+                run.waitingForEvent = undefined;
+                run.steps = (0, wait_state_1.applyWaitEvent)(run.steps, event);
+                break;
+            }
+            case 'flow:complete':
+                run.status = event.status;
+                run.durationMs = event.durationMs;
+                run.endTime = event.timestamp;
+                run.error = event.error;
+                break;
+            default:
+                break;
+        }
+    }
+    getOrCreateStep(run, stepId, stepName) {
+        let step = run.steps[stepId];
+        if (!step) {
+            step = {
+                stepId,
+                stepName: stepName || stepId,
+                status: 'PENDING',
+                attempts: 1
+            };
+            run.steps[stepId] = step;
+        }
+        if (stepName && (!step.stepName || step.stepName === stepId)) {
+            step.stepName = stepName;
+        }
+        return step;
+    }
+    getRun(stackId) {
+        return this.runs.get(stackId);
+    }
+    listRuns(filter) {
+        let list = Array.from(this.runs.values());
+        if (filter?.namespace) {
+            list = list.filter(r => r.namespace === filter.namespace);
+        }
+        if (filter?.status) {
+            list = list.filter(r => r.status === filter.status);
+        }
+        return list.sort((a, b) => b.startTime - a.startTime);
+    }
+    clear() {
+        this.runs.clear();
+    }
+}
+exports.WorkflowExecutionStore = WorkflowExecutionStore;
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

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

package/dist/transports/redis.d.ts

@@ -0,0 +1,26 @@
+import { WorkflowExecutionEvent, WorkflowEventEmitter, RedactionOptions } from '@siglo/core';
+export interface RedisPubSubClient {
+    publish(channel: string, message: string): Promise<number | any> | number | any;
+    subscribe(channel: string, listener?: (message: string) => void): Promise<any> | any;
+    on?(event: 'message', listener: (channel: string, message: string) => void): any;
+}
+export interface RedisMonitoringOptions {
+    channel?: string;
+    publisher?: RedisPubSubClient;
+    subscriber?: RedisPubSubClient;
+    emitter?: WorkflowEventEmitter;
+    redaction?: RedactionOptions;
+}
+export declare class RedisMonitoringAdapter {
+    private channel;
+    private publisher?;
+    private subscriber?;
+    private emitter?;
+    private redaction?;
+    constructor(options: RedisMonitoringOptions);
+    private setupSubscription;
+    private handleIncoming;
+    publish(event: WorkflowExecutionEvent): Promise<void>;
+    attachToEmitter(emitter: WorkflowEventEmitter): this;
+}
+//# sourceMappingURL=redis.d.ts.map

package/dist/transports/redis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis.d.ts","sourceRoot":"","sources":["../../src/transports/redis.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAe,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE1G,MAAM,WAAW,iBAAiB;IAC9B,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,GAAG,MAAM,GAAG,GAAG,CAAC;IAChF,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IACrF,EAAE,CAAC,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,GAAG,CAAC;CACpF;AAED,MAAM,WAAW,sBAAsB;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAChC;AAED,qBAAa,sBAAsB;IAC/B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAC,CAAoB;IACtC,OAAO,CAAC,UAAU,CAAC,CAAoB;IACvC,OAAO,CAAC,OAAO,CAAC,CAAuB;IACvC,OAAO,CAAC,SAAS,CAAC,CAAmB;gBAEzB,OAAO,EAAE,sBAAsB;IAY3C,OAAO,CAAC,iBAAiB;IAiBzB,OAAO,CAAC,cAAc;IAWhB,OAAO,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAW3D,eAAe,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI;CAOvD"}

package/dist/transports/redis.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedisMonitoringAdapter = void 0;
+const core_1 = require("@siglo/core");
+class RedisMonitoringAdapter {
+    channel;
+    publisher;
+    subscriber;
+    emitter;
+    redaction;
+    constructor(options) {
+        this.channel = options.channel || 'siglo:monitor:events';
+        this.publisher = options.publisher;
+        this.subscriber = options.subscriber;
+        this.emitter = options.emitter;
+        this.redaction = options.redaction;
+        if (this.subscriber) {
+            this.setupSubscription();
+        }
+    }
+    setupSubscription() {
+        if (!this.subscriber)
+            return;
+        if (typeof this.subscriber.on === 'function') {
+            this.subscriber.on('message', (chan, msg) => {
+                if (chan === this.channel) {
+                    this.handleIncoming(msg);
+                }
+            });
+            this.subscriber.subscribe(this.channel);
+        }
+        else {
+            this.subscriber.subscribe(this.channel, (msg) => {
+                this.handleIncoming(msg);
+            });
+        }
+    }
+    handleIncoming(raw) {
+        try {
+            const event = JSON.parse(raw);
+            if (this.emitter) {
+                this.emitter.emit(event);
+            }
+        }
+        catch {
+            // Ignore corrupted json
+        }
+    }
+    async publish(event) {
+        if (!this.publisher || !event)
+            return;
+        const sanitized = (0, core_1.redactEvent)(event, this.redaction);
+        const serialized = JSON.stringify(sanitized);
+        try {
+            await this.publisher.publish(this.channel, serialized);
+        }
+        catch {
+            // Non-functional requirement: monitoring failures never crash execution
+        }
+    }
+    attachToEmitter(emitter) {
+        this.emitter = emitter;
+        emitter.on('*', (event) => {
+            this.publish(event).catch(() => { });
+        });
+        return this;
+    }
+}
+exports.RedisMonitoringAdapter = RedisMonitoringAdapter;
+//# sourceMappingURL=redis.js.map

package/dist/transports/redis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis.js","sourceRoot":"","sources":["../../src/transports/redis.ts"],"names":[],"mappings":";;;AAAA,sCAA0G;AAgB1G,MAAa,sBAAsB;IACvB,OAAO,CAAS;IAChB,SAAS,CAAqB;IAC9B,UAAU,CAAqB;IAC/B,OAAO,CAAwB;IAC/B,SAAS,CAAoB;IAErC,YAAY,OAA+B;QACvC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,sBAAsB,CAAC;QACzD,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QAEnC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YAClB,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC7B,CAAC;IACL,CAAC;IAEO,iBAAiB;QACrB,IAAI,CAAC,IAAI,CAAC,UAAU;YAAE,OAAO;QAE7B,IAAI,OAAO,IAAI,CAAC,UAAU,CAAC,EAAE,KAAK,UAAU,EAAE,CAAC;YAC3C,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,IAAY,EAAE,GAAW,EAAE,EAAE;gBACxD,IAAI,IAAI,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;oBACxB,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;gBAC7B,CAAC;YACL,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5C,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,GAAW,EAAE,EAAE;gBACpD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;YAC7B,CAAC,CAAC,CAAC;QACP,CAAC;IACL,CAAC;IAEO,cAAc,CAAC,GAAW;QAC9B,IAAI,CAAC;YACD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA2B,CAAC;YACxD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACf,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC7B,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACL,wBAAwB;QAC5B,CAAC;IACL,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAA6B;QACvC,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,KAAK;YAAE,OAAO;QACtC,MAAM,SAAS,GAAG,IAAA,kBAAW,EAAC,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QACrD,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC;YACD,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QAC3D,CAAC;QAAC,MAAM,CAAC;YACL,wEAAwE;QAC5E,CAAC;IACL,CAAC;IAED,eAAe,CAAC,OAA6B;QACzC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,EAAE;YACtB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ;AAjED,wDAiEC"}

package/dist/transports/sse.d.ts

@@ -0,0 +1,24 @@
+import { IncomingMessage, ServerResponse } from 'http';
+import { WorkflowExecutionEvent, RedactionOptions } from '@siglo/core';
+export interface SSEClient {
+    id: string;
+    res: ServerResponse;
+    namespace?: string;
+}
+export declare class SSEBroadcaster {
+    private clients;
+    private redaction?;
+    private heartbeatTimer?;
+    constructor(options?: {
+        redaction?: RedactionOptions;
+        heartbeatIntervalMs?: number;
+    });
+    addClient(res: ServerResponse, namespace?: string): SSEClient;
+    removeClient(client: SSEClient): void;
+    broadcast(event: WorkflowExecutionEvent): void;
+    sendHeartbeat(): void;
+    getClientCount(): number;
+    close(): void;
+}
+export declare function createSSEHandler(broadcaster: SSEBroadcaster): (req: IncomingMessage, res: ServerResponse) => void;
+//# sourceMappingURL=sse.d.ts.map

package/dist/transports/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../src/transports/sse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAe,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpF,MAAM,WAAW,SAAS;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,cAAc,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,cAAc;IACvB,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,SAAS,CAAC,CAAmB;IACrC,OAAO,CAAC,cAAc,CAAC,CAAiB;gBAE5B,OAAO,CAAC,EAAE;QAClB,SAAS,CAAC,EAAE,gBAAgB,CAAC;QAC7B,mBAAmB,CAAC,EAAE,MAAM,CAAC;KAChC;IAQD,SAAS,CAAC,GAAG,EAAE,cAAc,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS;IA8B7D,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAIrC,SAAS,CAAC,KAAK,EAAE,sBAAsB,GAAG,IAAI;IAmB9C,aAAa,IAAI,IAAI;IAUrB,cAAc,IAAI,MAAM;IAIxB,KAAK,IAAI,IAAI;CAchB;AAED,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,cAAc,SAC3C,eAAe,OAAO,cAAc,KAAG,IAAI,CAK3D"}

package/dist/transports/sse.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SSEBroadcaster = void 0;
+exports.createSSEHandler = createSSEHandler;
+const core_1 = require("@siglo/core");
+class SSEBroadcaster {
+    clients = new Set();
+    redaction;
+    heartbeatTimer;
+    constructor(options) {
+        this.redaction = options?.redaction;
+        const interval = options?.heartbeatIntervalMs || 15000;
+        this.heartbeatTimer = setInterval(() => {
+            this.sendHeartbeat();
+        }, interval);
+    }
+    addClient(res, namespace) {
+        res.writeHead(200, {
+            'Content-Type': 'text/event-stream',
+            'Cache-Control': 'no-cache, no-transform',
+            'Connection': 'keep-alive',
+            'X-Accel-Buffering': 'no'
+        });
+        const client = {
+            id: Math.random().toString(36).slice(2),
+            res,
+            namespace
+        };
+        this.clients.add(client);
+        // Send connected handshake
+        res.write(`: connected\\n\\n`);
+        res.on('close', () => {
+            this.removeClient(client);
+        });
+        res.on('error', () => {
+            this.removeClient(client);
+        });
+        return client;
+    }
+    removeClient(client) {
+        this.clients.delete(client);
+    }
+    broadcast(event) {
+        if (!event)
+            return;
+        const sanitized = (0, core_1.redactEvent)(event, this.redaction);
+        const data = JSON.stringify(sanitized);
+        const message = `event: ${sanitized.type}\\ndata: ${data}\\n\\n`;
+        for (const client of Array.from(this.clients)) {
+            if (client.namespace && sanitized.namespace && client.namespace !== sanitized.namespace) {
+                continue;
+            }
+            try {
+                client.res.write(message);
+            }
+            catch {
+                this.removeClient(client);
+            }
+        }
+    }
+    sendHeartbeat() {
+        for (const client of Array.from(this.clients)) {
+            try {
+                client.res.write(':keepalive\\n\\n');
+            }
+            catch {
+                this.removeClient(client);
+            }
+        }
+    }
+    getClientCount() {
+        return this.clients.size;
+    }
+    close() {
+        if (this.heartbeatTimer) {
+            clearInterval(this.heartbeatTimer);
+            this.heartbeatTimer = undefined;
+        }
+        for (const client of Array.from(this.clients)) {
+            try {
+                client.res.end();
+            }
+            catch {
+                // ignore
+            }
+        }
+        this.clients.clear();
+    }
+}
+exports.SSEBroadcaster = SSEBroadcaster;
+function createSSEHandler(broadcaster) {
+    return (req, res) => {
+        const url = new URL(req.url || '/', `http://${req.headers?.host || 'localhost'}`);
+        const namespace = url.searchParams.get('namespace') || undefined;
+        broadcaster.addClient(res, namespace);
+    };
+}
+//# sourceMappingURL=sse.js.map

package/dist/transports/sse.js.map

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

package/dist/transports/websocket.d.ts

@@ -0,0 +1,37 @@
+import { IncomingMessage, Server as HttpServer } from 'http';
+import { Socket } from 'net';
+import { WorkflowExecutionEvent, RedactionOptions } from '@siglo/core';
+import { MonitorClientMessage } from '../types';
+export interface WSClient {
+    id: string;
+    socket: Socket;
+    namespace?: string;
+}
+export declare class WebSocketBroadcaster {
+    private clients;
+    private redaction?;
+    private onClientMessageCallback?;
+    private authenticateCallback?;
+    private allowRemoteResume;
+    private maxPayloadBytes;
+    private authorizeMessage?;
+    constructor(options?: {
+        redaction?: RedactionOptions;
+        maxPayloadBytes?: number;
+        authorizeMessage?: (message: MonitorClientMessage, req: IncomingMessage) => boolean;
+        onClientMessage?: (message: MonitorClientMessage, client: WSClient) => void;
+        authenticate?: (req: IncomingMessage) => boolean;
+        allowRemoteResume?: boolean;
+    });
+    attach(server: HttpServer, path?: string): void;
+    private setupSocket;
+    private handleMessage;
+    private sendPong;
+    broadcast(event: WorkflowExecutionEvent): void;
+    send(client: WSClient, message: any): void;
+    private encodeTextFrame;
+    removeClient(client: WSClient): void;
+    getClientCount(): number;
+    close(): void;
+}
+//# sourceMappingURL=websocket.d.ts.map

package/dist/transports/websocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../../src/transports/websocket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,MAAM,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,EAAE,sBAAsB,EAAe,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpF,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAEhD,MAAM,WAAW,QAAQ;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAID,qBAAa,oBAAoB;IAC7B,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,SAAS,CAAC,CAAmB;IACrC,OAAO,CAAC,uBAAuB,CAAC,CAA4D;IAC5F,OAAO,CAAC,oBAAoB,CAAC,CAAoC;IACjE,OAAO,CAAC,iBAAiB,CAAU;IACnC,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,gBAAgB,CAAC,CAAmE;gBAEhF,OAAO,CAAC,EAAE;QAClB,SAAS,CAAC,EAAE,gBAAgB,CAAC;QAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC;QACpF,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,oBAAoB,EAAE,MAAM,EAAE,QAAQ,KAAK,IAAI,CAAC;QAC5E,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC;QACjD,iBAAiB,CAAC,EAAE,OAAO,CAAC;KAC/B;IASD,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,GAAE,MAAc,GAAG,IAAI;IAiDtD,OAAO,CAAC,WAAW;IAmFnB,OAAO,CAAC,aAAa;IAmBrB,OAAO,CAAC,QAAQ;IAYhB,SAAS,CAAC,KAAK,EAAE,sBAAsB,GAAG,IAAI;IAmB9C,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,GAAG,IAAI;IAU1C,OAAO,CAAC,eAAe;IAwBvB,YAAY,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI;IAIpC,cAAc,IAAI,MAAM;IAIxB,KAAK,IAAI,IAAI;CAUhB"}