sudocode 1.0.0 → 1.1.1

package/node_modules/@sudocode-ai/local-server/dist/execution/transport/sse-transport.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Server-Sent Events (SSE) Transport Layer
+ *
+ * Provides real-time streaming of AG-UI events to frontend clients using SSE.
+ * Supports connection management, heartbeat, and run-specific event filtering.
+ *
+ * @module execution/transport/sse-transport
+ */
+import type { Response } from "express";
+/**
+ * SSE Event to send to clients
+ *
+ * Follows the SSE specification format
+ */
+interface SseEvent {
+    /** Event type (optional, defaults to 'message') */
+    event?: string;
+    /** Event data (will be JSON stringified) */
+    data: any;
+    /** Event ID (optional) */
+    id?: string;
+}
+/**
+ * SseTransport - Server-Sent Events transport for AG-UI events
+ *
+ * Manages SSE connections and streams AG-UI protocol events to connected clients.
+ * Supports multiple concurrent connections, heartbeat mechanism, and run-specific filtering.
+ *
+ * @example
+ * ```typescript
+ * const transport = new SseTransport();
+ *
+ * // Handle new connection
+ * app.get('/api/events', (req, res) => {
+ *   const clientId = req.query.clientId as string;
+ *   const runId = req.query.runId as string | undefined;
+ *   transport.handleConnection(clientId, res, runId);
+ * });
+ *
+ * // Send event to specific client
+ * transport.sendToClient('client-123', {
+ *   event: 'TOOL_CALL_START',
+ *   data: { type: 'TOOL_CALL_START', toolCallId: 'tool-1' }
+ * });
+ *
+ * // Broadcast to all clients watching a specific run
+ * transport.broadcastToRun('run-123', {
+ *   event: 'RUN_FINISHED',
+ *   data: { type: 'RUN_FINISHED', runId: 'run-123' }
+ * });
+ * ```
+ */
+export declare class SseTransport {
+    private clients;
+    private heartbeatInterval;
+    private readonly HEARTBEAT_INTERVAL_MS;
+    /**
+     * Create a new SSE transport instance
+     */
+    constructor();
+    /**
+     * Handle a new SSE connection from a client
+     *
+     * Sets up proper SSE headers, registers the client, and handles cleanup on disconnect.
+     *
+     * @param clientId - Unique identifier for this client
+     * @param res - Express response object
+     * @param runId - Optional run ID to filter events
+     * @param replayEvents - Optional: buffered events to replay to this client
+     */
+    handleConnection(clientId: string, res: Response, runId?: string, replayEvents?: Array<{
+        event: string;
+        data: any;
+    }>): void;
+    /**
+     * Send an event to a specific client
+     *
+     * @param clientId - Target client ID
+     * @param event - Event to send
+     * @returns true if sent successfully, false if client not found
+     */
+    sendToClient(clientId: string, event: SseEvent): boolean;
+    /**
+     * Broadcast an event to all connected clients
+     *
+     * @param event - Event to broadcast
+     * @returns Number of clients that received the event
+     */
+    broadcast(event: SseEvent): number;
+    /**
+     * Broadcast an event to all clients watching a specific run
+     *
+     * @param runId - Target run ID
+     * @param event - Event to send
+     * @returns Number of clients that received the event
+     */
+    broadcastToRun(runId: string, event: SseEvent): number;
+    /**
+     * Remove a client connection
+     *
+     * @param clientId - Client to remove
+     * @returns true if client was removed, false if not found
+     */
+    removeClient(clientId: string): boolean;
+    /**
+     * Get the number of active connections
+     *
+     * @returns Number of connected clients
+     */
+    getClientCount(): number;
+    /**
+     * Get the number of clients watching a specific run
+     *
+     * @param runId - Run ID to check
+     * @returns Number of clients watching this run
+     */
+    getRunClientCount(runId: string): number;
+    /**
+     * Get all active client IDs
+     *
+     * @returns Array of client IDs
+     */
+    getClientIds(): string[];
+    /**
+     * Shutdown the transport and close all connections
+     */
+    shutdown(): void;
+    /**
+     * Write an event to a client connection
+     *
+     * Formats the event according to SSE specification and writes it to the response.
+     *
+     * @param client - Target client
+     * @param event - Event to write
+     * @returns true if successful, false if write failed
+     */
+    private writeEvent;
+    /**
+     * Start the heartbeat mechanism
+     *
+     * Sends periodic ping events to keep connections alive
+     */
+    private startHeartbeat;
+}
+export {};
+//# sourceMappingURL=sse-transport.d.ts.map

package/node_modules/@sudocode-ai/local-server/dist/execution/transport/sse-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse-transport.d.ts","sourceRoot":"","sources":["../../../src/execution/transport/sse-transport.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAoBxC;;;;GAIG;AACH,UAAU,QAAQ;IAChB,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,IAAI,EAAE,GAAG,CAAC;IACV,0BAA0B;IAC1B,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,iBAAiB,CAA+B;IACxD,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAS;IAE/C;;OAEG;;IAKH;;;;;;;;;OASG;IACH,gBAAgB,CACd,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,QAAQ,EACb,KAAK,CAAC,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,GAAG,CAAA;KAAE,CAAC,GACjD,IAAI;IA8CP;;;;;;OAMG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO;IASxD;;;;;OAKG;IACH,SAAS,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM;IAYlC;;;;;;OAMG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,MAAM;IAgBtD;;;;;OAKG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAmBvC;;;;OAIG;IACH,cAAc,IAAI,MAAM;IAIxB;;;;;OAKG;IACH,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAUxC;;;;OAIG;IACH,YAAY,IAAI,MAAM,EAAE;IAIxB;;OAEG;IACH,QAAQ,IAAI,IAAI;IAahB;;;;;;;;OAQG;IACH,OAAO,CAAC,UAAU;IAoDlB;;;;OAIG;IACH,OAAO,CAAC,cAAc;CAavB"}

package/node_modules/@sudocode-ai/local-server/dist/execution/transport/sse-transport.js

@@ -0,0 +1,282 @@
+/**
+ * Server-Sent Events (SSE) Transport Layer
+ *
+ * Provides real-time streaming of AG-UI events to frontend clients using SSE.
+ * Supports connection management, heartbeat, and run-specific event filtering.
+ *
+ * @module execution/transport/sse-transport
+ */
+/**
+ * SseTransport - Server-Sent Events transport for AG-UI events
+ *
+ * Manages SSE connections and streams AG-UI protocol events to connected clients.
+ * Supports multiple concurrent connections, heartbeat mechanism, and run-specific filtering.
+ *
+ * @example
+ * ```typescript
+ * const transport = new SseTransport();
+ *
+ * // Handle new connection
+ * app.get('/api/events', (req, res) => {
+ *   const clientId = req.query.clientId as string;
+ *   const runId = req.query.runId as string | undefined;
+ *   transport.handleConnection(clientId, res, runId);
+ * });
+ *
+ * // Send event to specific client
+ * transport.sendToClient('client-123', {
+ *   event: 'TOOL_CALL_START',
+ *   data: { type: 'TOOL_CALL_START', toolCallId: 'tool-1' }
+ * });
+ *
+ * // Broadcast to all clients watching a specific run
+ * transport.broadcastToRun('run-123', {
+ *   event: 'RUN_FINISHED',
+ *   data: { type: 'RUN_FINISHED', runId: 'run-123' }
+ * });
+ * ```
+ */
+export class SseTransport {
+    clients = new Map();
+    heartbeatInterval = null;
+    HEARTBEAT_INTERVAL_MS = 30000; // 30 seconds
+    /**
+     * Create a new SSE transport instance
+     */
+    constructor() {
+        this.startHeartbeat();
+    }
+    /**
+     * Handle a new SSE connection from a client
+     *
+     * Sets up proper SSE headers, registers the client, and handles cleanup on disconnect.
+     *
+     * @param clientId - Unique identifier for this client
+     * @param res - Express response object
+     * @param runId - Optional run ID to filter events
+     * @param replayEvents - Optional: buffered events to replay to this client
+     */
+    handleConnection(clientId, res, runId, replayEvents) {
+        // Set SSE headers
+        res.setHeader("Content-Type", "text/event-stream");
+        res.setHeader("Cache-Control", "no-cache");
+        res.setHeader("Connection", "keep-alive");
+        res.setHeader("X-Accel-Buffering", "no"); // Disable nginx buffering
+        // Enable CORS for SSE (if needed)
+        res.setHeader("Access-Control-Allow-Origin", "*");
+        // Disable compression for SSE
+        res.flushHeaders();
+        const client = {
+            clientId,
+            response: res,
+            runId,
+            connectedAt: new Date(),
+            lastActivity: new Date(),
+        };
+        this.clients.set(clientId, client);
+        // Send initial connection acknowledgment
+        this.sendToClient(clientId, {
+            event: "connected",
+            data: {
+                clientId,
+                runId,
+                timestamp: Date.now(),
+            },
+        });
+        // Replay buffered events if provided
+        if (replayEvents && replayEvents.length > 0) {
+            for (const event of replayEvents) {
+                this.sendToClient(clientId, event);
+            }
+        }
+        // Handle client disconnect
+        res.on("close", () => {
+            this.removeClient(clientId);
+        });
+    }
+    /**
+     * Send an event to a specific client
+     *
+     * @param clientId - Target client ID
+     * @param event - Event to send
+     * @returns true if sent successfully, false if client not found
+     */
+    sendToClient(clientId, event) {
+        const client = this.clients.get(clientId);
+        if (!client) {
+            return false;
+        }
+        return this.writeEvent(client, event);
+    }
+    /**
+     * Broadcast an event to all connected clients
+     *
+     * @param event - Event to broadcast
+     * @returns Number of clients that received the event
+     */
+    broadcast(event) {
+        let sentCount = 0;
+        for (const client of this.clients.values()) {
+            if (this.writeEvent(client, event)) {
+                sentCount++;
+            }
+        }
+        return sentCount;
+    }
+    /**
+     * Broadcast an event to all clients watching a specific run
+     *
+     * @param runId - Target run ID
+     * @param event - Event to send
+     * @returns Number of clients that received the event
+     */
+    broadcastToRun(runId, event) {
+        let sentCount = 0;
+        let matchingClients = 0;
+        for (const client of this.clients.values()) {
+            if (client.runId === runId) {
+                matchingClients++;
+                if (this.writeEvent(client, event)) {
+                    sentCount++;
+                }
+            }
+        }
+        return sentCount;
+    }
+    /**
+     * Remove a client connection
+     *
+     * @param clientId - Client to remove
+     * @returns true if client was removed, false if not found
+     */
+    removeClient(clientId) {
+        const client = this.clients.get(clientId);
+        if (!client) {
+            return false;
+        }
+        // Try to close the response if it's still open
+        try {
+            if (!client.response.writableEnded) {
+                client.response.end();
+            }
+        }
+        catch (error) {
+            // Connection already closed, ignore
+        }
+        this.clients.delete(clientId);
+        return true;
+    }
+    /**
+     * Get the number of active connections
+     *
+     * @returns Number of connected clients
+     */
+    getClientCount() {
+        return this.clients.size;
+    }
+    /**
+     * Get the number of clients watching a specific run
+     *
+     * @param runId - Run ID to check
+     * @returns Number of clients watching this run
+     */
+    getRunClientCount(runId) {
+        let count = 0;
+        for (const client of this.clients.values()) {
+            if (client.runId === runId) {
+                count++;
+            }
+        }
+        return count;
+    }
+    /**
+     * Get all active client IDs
+     *
+     * @returns Array of client IDs
+     */
+    getClientIds() {
+        return Array.from(this.clients.keys());
+    }
+    /**
+     * Shutdown the transport and close all connections
+     */
+    shutdown() {
+        // Stop heartbeat
+        if (this.heartbeatInterval) {
+            clearInterval(this.heartbeatInterval);
+            this.heartbeatInterval = null;
+        }
+        // Close all client connections
+        for (const clientId of this.clients.keys()) {
+            this.removeClient(clientId);
+        }
+    }
+    /**
+     * Write an event to a client connection
+     *
+     * Formats the event according to SSE specification and writes it to the response.
+     *
+     * @param client - Target client
+     * @param event - Event to write
+     * @returns true if successful, false if write failed
+     */
+    writeEvent(client, event) {
+        try {
+            const { response } = client;
+            // Check if response is still writable
+            if (response.writableEnded || !response.writable) {
+                this.removeClient(client.clientId);
+                return false;
+            }
+            // Format SSE message
+            let message = "";
+            // Add event type if specified
+            if (event.event) {
+                message += `event: ${event.event}\n`;
+            }
+            // Add event ID if specified
+            if (event.id) {
+                message += `id: ${event.id}\n`;
+            }
+            // Add data (JSON stringify if object)
+            const dataString = typeof event.data === "string"
+                ? event.data
+                : JSON.stringify(event.data);
+            // SSE spec requires data to be on separate lines if multiline
+            const dataLines = dataString.split("\n");
+            for (const line of dataLines) {
+                message += `data: ${line}\n`;
+            }
+            // SSE messages end with double newline
+            message += "\n";
+            // Write to response
+            response.write(message);
+            // Update last activity
+            client.lastActivity = new Date();
+            return true;
+        }
+        catch (error) {
+            // Connection error, remove client
+            this.removeClient(client.clientId);
+            return false;
+        }
+    }
+    /**
+     * Start the heartbeat mechanism
+     *
+     * Sends periodic ping events to keep connections alive
+     */
+    startHeartbeat() {
+        this.heartbeatInterval = setInterval(() => {
+            const pingEvent = {
+                event: "ping",
+                data: { timestamp: Date.now() },
+            };
+            // Send ping to all clients
+            for (const client of this.clients.values()) {
+                this.writeEvent(client, pingEvent);
+            }
+        }, this.HEARTBEAT_INTERVAL_MS);
+    }
+}
+//# sourceMappingURL=sse-transport.js.map

package/node_modules/@sudocode-ai/local-server/dist/execution/transport/sse-transport.js.map

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

package/node_modules/@sudocode-ai/local-server/dist/execution/transport/transport-manager.d.ts

@@ -0,0 +1,176 @@
+/**
+ * Transport Manager
+ *
+ * Coordinates between AG-UI adapter and SSE transport layer.
+ * Acts as a facade that routes adapter events to appropriate transport methods.
+ *
+ * @module execution/transport/transport-manager
+ */
+import type { AgUiEventAdapter } from "../output/ag-ui-adapter.js";
+import type { RunStartedEvent, RunFinishedEvent, RunErrorEvent, StepStartedEvent, StepFinishedEvent, ToolCallStartEvent, ToolCallArgsEvent, ToolCallEndEvent, ToolCallResultEvent, TextMessageStartEvent, TextMessageContentEvent, TextMessageEndEvent, StateDeltaEvent, StateSnapshotEvent, CustomEvent } from "@ag-ui/core";
+import { SseTransport } from "./sse-transport.js";
+/**
+ * Union type for all AG-UI events
+ */
+export type AgUiEvent = RunStartedEvent | RunFinishedEvent | RunErrorEvent | StepStartedEvent | StepFinishedEvent | ToolCallStartEvent | ToolCallArgsEvent | ToolCallEndEvent | ToolCallResultEvent | TextMessageStartEvent | TextMessageContentEvent | TextMessageEndEvent | StateDeltaEvent | StateSnapshotEvent | CustomEvent;
+/**
+ * TransportManager - Coordinates AG-UI events with SSE transport
+ *
+ * Manages the connection between AG-UI adapters and SSE transport,
+ * routing events to appropriate broadcast methods based on run filtering.
+ *
+ * @example
+ * ```typescript
+ * const manager = new TransportManager();
+ * const adapter = new AgUiEventAdapter('run-123');
+ *
+ * // Connect adapter to transport
+ * manager.connectAdapter(adapter, 'run-123');
+ *
+ * // Events from adapter are now automatically broadcast via SSE
+ * ```
+ */
+export declare class TransportManager {
+    private sseTransport;
+    private eventBuffer;
+    private adapterListeners;
+    private pruneInterval;
+    /**
+     * Create a new transport manager
+     *
+     * Initializes the SSE transport layer and event buffer
+     */
+    constructor();
+    /**
+     * Connect AG-UI adapter to SSE transport
+     *
+     * Subscribes to adapter's event stream and routes events to SSE transport.
+     * If runId is provided, events are broadcast only to clients watching that run.
+     * Otherwise, events are broadcast to all connected clients.
+     *
+     * @param adapter - AG-UI event adapter to connect
+     * @param runId - Optional run ID for filtering events
+     *
+     * @example
+     * ```typescript
+     * const adapter = new AgUiEventAdapter('run-123');
+     * manager.connectAdapter(adapter, 'run-123');
+     * ```
+     */
+    connectAdapter(adapter: AgUiEventAdapter, runId?: string): void;
+    /**
+     * Disconnect AG-UI adapter from transport
+     *
+     * Removes the adapter's event listener and stops broadcasting its events.
+     *
+     * @param adapter - AG-UI event adapter to disconnect
+     * @returns true if adapter was disconnected, false if not found
+     */
+    disconnectAdapter(adapter: AgUiEventAdapter): boolean;
+    /**
+     * Broadcast event to all connected clients
+     *
+     * @param event - AG-UI event to broadcast
+     * @returns Number of clients that received the event
+     *
+     * @example
+     * ```typescript
+     * manager.broadcast({
+     *   type: EventType.RUN_STARTED,
+     *   runId: 'run-123',
+     *   threadId: 'run-123',
+     *   timestamp: Date.now()
+     * });
+     * ```
+     */
+    broadcast(event: AgUiEvent): number;
+    /**
+     * Broadcast event to clients watching a specific run
+     *
+     * @param runId - Target run ID
+     * @param event - AG-UI event to broadcast
+     * @returns Number of clients that received the event
+     *
+     * @example
+     * ```typescript
+     * manager.broadcastToRun('run-123', {
+     *   type: EventType.TOOL_CALL_START,
+     *   toolCallId: 'tool-1',
+     *   toolCallName: 'Read',
+     *   timestamp: Date.now()
+     * });
+     * ```
+     */
+    broadcastToRun(runId: string, event: AgUiEvent): number;
+    /**
+     * Get underlying SSE transport
+     *
+     * Provides access to the SSE transport for route handlers
+     * that need to manage client connections.
+     *
+     * @returns SSE transport instance
+     *
+     * @example
+     * ```typescript
+     * const transport = manager.getSseTransport();
+     *
+     * // Handle SSE connection in route
+     * app.get('/api/events', (req, res) => {
+     *   transport.handleConnection(clientId, res, runId);
+     * });
+     * ```
+     */
+    getSseTransport(): SseTransport;
+    /**
+     * Get number of connected adapters
+     *
+     * @returns Number of active adapter connections
+     */
+    getAdapterCount(): number;
+    /**
+     * Get buffered events for an execution
+     *
+     * Returns all events that have been buffered for the specified execution.
+     * Useful for replaying events to late-joining clients.
+     *
+     * @param runId - Target run ID
+     * @param fromSequence - Optional: only return events >= this sequence number
+     * @returns Array of buffered events
+     *
+     * @example
+     * ```typescript
+     * const events = manager.getBufferedEvents('run-123');
+     * for (const buffered of events) {
+     *   console.log(buffered.event.type, buffered.sequenceNumber);
+     * }
+     * ```
+     */
+    getBufferedEvents(runId: string, fromSequence?: number): import("./event-buffer.js").BufferedEvent[];
+    /**
+     * Check if events are buffered for an execution
+     *
+     * @param runId - Target run ID
+     * @returns true if events are buffered
+     */
+    hasBufferedEvents(runId: string): boolean;
+    /**
+     * Get buffer statistics
+     *
+     * @returns Buffer statistics
+     */
+    getBufferStats(): {
+        bufferCount: number;
+        totalEvents: number;
+        avgEventsPerBuffer: number;
+        oldestBuffer: number | null;
+        newestBuffer: number | null;
+    };
+    /**
+     * Shutdown transport manager
+     *
+     * Disconnects all adapters and shuts down SSE transport.
+     * Closes all client connections and releases resources.
+     */
+    shutdown(): void;
+}
+//# sourceMappingURL=transport-manager.d.ts.map

package/node_modules/@sudocode-ai/local-server/dist/execution/transport/transport-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-manager.d.ts","sourceRoot":"","sources":["../../../src/execution/transport/transport-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EACvB,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,WAAW,EACZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD;;GAEG;AACH,MAAM,MAAM,SAAS,GACjB,eAAe,GACf,gBAAgB,GAChB,aAAa,GACb,gBAAgB,GAChB,iBAAiB,GACjB,kBAAkB,GAClB,iBAAiB,GACjB,gBAAgB,GAChB,mBAAmB,GACnB,qBAAqB,GACrB,uBAAuB,GACvB,mBAAmB,GACnB,eAAe,GACf,kBAAkB,GAClB,WAAW,CAAC;AAEhB;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,gBAAgB,CACZ;IACZ,OAAO,CAAC,aAAa,CAA+B;IAEpD;;;;OAIG;;IAcH;;;;;;;;;;;;;;;OAeG;IACH,cAAc,CAAC,OAAO,EAAE,gBAAgB,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAmB/D;;;;;;;OAOG;IACH,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO;IAWrD;;;;;;;;;;;;;;;OAeG;IACH,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM;IAOnC;;;;;;;;;;;;;;;;OAgBG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,MAAM;IAQvD;;;;;;;;;;;;;;;;;OAiBG;IACH,eAAe,IAAI,YAAY;IAI/B;;;;OAIG;IACH,eAAe,IAAI,MAAM;IAIzB;;;;;;;;;;;;;;;;;OAiBG;IACH,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;IAItD;;;;;OAKG;IACH,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIzC;;;;OAIG;IACH,cAAc;;;;;;;IAId;;;;;OAKG;IACH,QAAQ,IAAI,IAAI;CAkBjB"}