@herdctl/web 0.0.1 → 0.1.1

package/dist/server/__tests__/ws-handler.test.js

@@ -0,0 +1,380 @@
+/**
+ * WebSocket handler and type guard tests for @herdctl/web
+ *
+ * Tests the WebSocket message type guards and handler behavior.
+ */
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { isClientMessage, isChatSendMessage, isAgentStartedPayload, isAgentStoppedPayload } from "../ws/types.js";
+import { WebSocketHandler } from "../ws/handler.js";
+// =============================================================================
+// Type Guard Tests
+// =============================================================================
+describe("isClientMessage", () => {
+    it("accepts a valid subscribe message", () => {
+        expect(isClientMessage({ type: "subscribe", payload: { agentName: "coder" } })).toBe(true);
+    });
+    it("accepts a valid unsubscribe message", () => {
+        expect(isClientMessage({ type: "unsubscribe", payload: { agentName: "coder" } })).toBe(true);
+    });
+    it("accepts a valid ping message", () => {
+        expect(isClientMessage({ type: "ping" })).toBe(true);
+    });
+    it("accepts a valid chat:send message", () => {
+        expect(isClientMessage({
+            type: "chat:send",
+            payload: {
+                agentName: "coder",
+                sessionId: "session-1",
+                message: "Hello",
+            },
+        })).toBe(true);
+    });
+    it("rejects null", () => {
+        expect(isClientMessage(null)).toBe(false);
+    });
+    it("rejects non-objects", () => {
+        expect(isClientMessage("string")).toBe(false);
+        expect(isClientMessage(42)).toBe(false);
+        expect(isClientMessage(undefined)).toBe(false);
+    });
+    it("rejects object without type", () => {
+        expect(isClientMessage({ payload: { agentName: "coder" } })).toBe(false);
+    });
+    it("rejects unknown type", () => {
+        expect(isClientMessage({ type: "unknown" })).toBe(false);
+    });
+    it("rejects subscribe without agentName", () => {
+        expect(isClientMessage({ type: "subscribe", payload: {} })).toBe(false);
+        expect(isClientMessage({ type: "subscribe", payload: null })).toBe(false);
+        expect(isClientMessage({ type: "subscribe" })).toBe(false);
+    });
+    it("rejects unsubscribe without agentName", () => {
+        expect(isClientMessage({ type: "unsubscribe", payload: {} })).toBe(false);
+    });
+});
+describe("isChatSendMessage", () => {
+    it("accepts valid chat:send message", () => {
+        expect(isChatSendMessage({
+            type: "chat:send",
+            payload: {
+                agentName: "coder",
+                sessionId: "session-1",
+                message: "Hello",
+            },
+        })).toBe(true);
+    });
+    it("rejects missing payload fields", () => {
+        expect(isChatSendMessage({
+            type: "chat:send",
+            payload: { agentName: "coder", sessionId: "session-1" },
+        })).toBe(false);
+    });
+    it("rejects wrong type", () => {
+        expect(isChatSendMessage({
+            type: "ping",
+            payload: {
+                agentName: "coder",
+                sessionId: "session-1",
+                message: "Hello",
+            },
+        })).toBe(false);
+    });
+    it("rejects null payload", () => {
+        expect(isChatSendMessage({ type: "chat:send", payload: null })).toBe(false);
+    });
+    it("rejects non-object", () => {
+        expect(isChatSendMessage(null)).toBe(false);
+        expect(isChatSendMessage("string")).toBe(false);
+    });
+});
+describe("isAgentStartedPayload", () => {
+    it("returns true for started payload", () => {
+        expect(isAgentStartedPayload({
+            agent: { name: "coder", status: "running" },
+        })).toBe(true);
+    });
+    it("returns false for stopped payload", () => {
+        expect(isAgentStartedPayload({
+            agentName: "coder",
+            reason: "completed",
+        })).toBe(false);
+    });
+});
+describe("isAgentStoppedPayload", () => {
+    it("returns true for stopped payload", () => {
+        expect(isAgentStoppedPayload({
+            agentName: "coder",
+            reason: "completed",
+        })).toBe(true);
+    });
+    it("returns false for started payload", () => {
+        expect(isAgentStoppedPayload({
+            agent: { name: "coder", status: "running" },
+        })).toBe(false);
+    });
+});
+// =============================================================================
+// WebSocketHandler Tests
+// =============================================================================
+describe("WebSocketHandler", () => {
+    let mockFleetManager;
+    beforeEach(() => {
+        mockFleetManager = {
+            getFleetStatus: vi.fn().mockResolvedValue({
+                state: "running",
+                counts: { totalAgents: 1 },
+            }),
+            on: vi.fn(),
+            off: vi.fn(),
+        };
+    });
+    it("can be instantiated", () => {
+        const handler = new WebSocketHandler(mockFleetManager);
+        expect(handler).toBeDefined();
+        expect(handler.getConnectedCount()).toBe(0);
+    });
+    it("reports zero subscribers for unknown agent", () => {
+        const handler = new WebSocketHandler(mockFleetManager);
+        expect(handler.getSubscriberCount("nonexistent")).toBe(0);
+    });
+    it("broadcasts to no clients when none connected", () => {
+        const handler = new WebSocketHandler(mockFleetManager);
+        // Should not throw when broadcasting to empty set
+        handler.broadcast({ type: "pong" });
+    });
+    it("broadcastToSubscribers does not throw with no clients", () => {
+        const handler = new WebSocketHandler(mockFleetManager);
+        // Should not throw when no one is subscribed
+        handler.broadcastToSubscribers("coder", { type: "pong" });
+    });
+    it("closeAll works on empty handler", () => {
+        const handler = new WebSocketHandler(mockFleetManager);
+        // Should not throw
+        handler.closeAll();
+        expect(handler.getConnectedCount()).toBe(0);
+    });
+    describe("handleConnection", () => {
+        it("tracks connected clients", async () => {
+            const handler = new WebSocketHandler(mockFleetManager);
+            const mockSocket = {
+                on: vi.fn(),
+                readyState: 1,
+                OPEN: 1,
+                send: vi.fn(),
+                close: vi.fn(),
+            };
+            await handler.handleConnection(mockSocket);
+            expect(handler.getConnectedCount()).toBe(1);
+            expect(mockSocket.on).toHaveBeenCalledWith("message", expect.any(Function));
+            expect(mockSocket.on).toHaveBeenCalledWith("close", expect.any(Function));
+            expect(mockSocket.on).toHaveBeenCalledWith("error", expect.any(Function));
+        });
+        it("sends initial fleet status on connection", async () => {
+            const handler = new WebSocketHandler(mockFleetManager);
+            const mockSocket = {
+                on: vi.fn(),
+                readyState: 1,
+                OPEN: 1,
+                send: vi.fn(),
+                close: vi.fn(),
+            };
+            await handler.handleConnection(mockSocket);
+            expect(mockFleetManager.getFleetStatus).toHaveBeenCalled();
+            expect(mockSocket.send).toHaveBeenCalledWith(expect.stringContaining('"type":"fleet:status"'));
+        });
+        it("handles disconnect", async () => {
+            const handler = new WebSocketHandler(mockFleetManager);
+            let closeHandler;
+            const mockSocket = {
+                on: vi.fn((event, cb) => {
+                    if (event === "close")
+                        closeHandler = cb;
+                }),
+                readyState: 1,
+                OPEN: 1,
+                send: vi.fn(),
+                close: vi.fn(),
+            };
+            await handler.handleConnection(mockSocket);
+            expect(handler.getConnectedCount()).toBe(1);
+            // Simulate disconnect
+            closeHandler();
+            expect(handler.getConnectedCount()).toBe(0);
+        });
+        it("handles subscribe and unsubscribe messages", async () => {
+            const handler = new WebSocketHandler(mockFleetManager);
+            let messageHandler;
+            const mockSocket = {
+                on: vi.fn((event, cb) => {
+                    if (event === "message")
+                        messageHandler = cb;
+                }),
+                readyState: 1,
+                OPEN: 1,
+                send: vi.fn(),
+                close: vi.fn(),
+            };
+            await handler.handleConnection(mockSocket);
+            // Subscribe to an agent
+            const subscribeMsg = JSON.stringify({
+                type: "subscribe",
+                payload: { agentName: "coder" },
+            });
+            messageHandler(Buffer.from(subscribeMsg));
+            expect(handler.getSubscriberCount("coder")).toBe(1);
+            // Unsubscribe from the agent
+            const unsubscribeMsg = JSON.stringify({
+                type: "unsubscribe",
+                payload: { agentName: "coder" },
+            });
+            messageHandler(Buffer.from(unsubscribeMsg));
+            expect(handler.getSubscriberCount("coder")).toBe(0);
+        });
+        it("responds to ping with pong", async () => {
+            const handler = new WebSocketHandler(mockFleetManager);
+            let messageHandler;
+            const mockSocket = {
+                on: vi.fn((event, cb) => {
+                    if (event === "message")
+                        messageHandler = cb;
+                }),
+                readyState: 1,
+                OPEN: 1,
+                send: vi.fn(),
+                close: vi.fn(),
+            };
+            await handler.handleConnection(mockSocket);
+            // Clear the initial fleet:status send
+            mockSocket.send.mockClear();
+            const pingMsg = JSON.stringify({ type: "ping" });
+            messageHandler(Buffer.from(pingMsg));
+            expect(mockSocket.send).toHaveBeenCalledWith(JSON.stringify({ type: "pong" }));
+        });
+        it("ignores invalid JSON messages", async () => {
+            const handler = new WebSocketHandler(mockFleetManager);
+            let messageHandler;
+            const mockSocket = {
+                on: vi.fn((event, cb) => {
+                    if (event === "message")
+                        messageHandler = cb;
+                }),
+                readyState: 1,
+                OPEN: 1,
+                send: vi.fn(),
+                close: vi.fn(),
+            };
+            await handler.handleConnection(mockSocket);
+            mockSocket.send.mockClear();
+            // Should not throw on invalid JSON
+            messageHandler(Buffer.from("not valid json"));
+            expect(mockSocket.send).not.toHaveBeenCalled();
+        });
+        it("ignores unknown message types", async () => {
+            const handler = new WebSocketHandler(mockFleetManager);
+            let messageHandler;
+            const mockSocket = {
+                on: vi.fn((event, cb) => {
+                    if (event === "message")
+                        messageHandler = cb;
+                }),
+                readyState: 1,
+                OPEN: 1,
+                send: vi.fn(),
+                close: vi.fn(),
+            };
+            await handler.handleConnection(mockSocket);
+            mockSocket.send.mockClear();
+            // Should not throw on unknown type (it's just filtered out)
+            messageHandler(Buffer.from(JSON.stringify({ type: "unknown" })));
+            expect(mockSocket.send).not.toHaveBeenCalled();
+        });
+    });
+    describe("broadcast", () => {
+        it("sends message to all connected clients", async () => {
+            const handler = new WebSocketHandler(mockFleetManager);
+            const socket1 = {
+                on: vi.fn(),
+                readyState: 1,
+                OPEN: 1,
+                send: vi.fn(),
+                close: vi.fn(),
+            };
+            const socket2 = {
+                on: vi.fn(),
+                readyState: 1,
+                OPEN: 1,
+                send: vi.fn(),
+                close: vi.fn(),
+            };
+            await handler.handleConnection(socket1);
+            await handler.handleConnection(socket2);
+            expect(handler.getConnectedCount()).toBe(2);
+            socket1.send.mockClear();
+            socket2.send.mockClear();
+            handler.broadcast({ type: "pong" });
+            expect(socket1.send).toHaveBeenCalledWith(JSON.stringify({ type: "pong" }));
+            expect(socket2.send).toHaveBeenCalledWith(JSON.stringify({ type: "pong" }));
+        });
+    });
+    describe("broadcastToSubscribers", () => {
+        it("sends message only to subscribed clients", async () => {
+            const handler = new WebSocketHandler(mockFleetManager);
+            let messageHandler1;
+            const socket1 = {
+                on: vi.fn((event, cb) => {
+                    if (event === "message")
+                        messageHandler1 = cb;
+                }),
+                readyState: 1,
+                OPEN: 1,
+                send: vi.fn(),
+                close: vi.fn(),
+            };
+            const socket2 = {
+                on: vi.fn(),
+                readyState: 1,
+                OPEN: 1,
+                send: vi.fn(),
+                close: vi.fn(),
+            };
+            await handler.handleConnection(socket1);
+            await handler.handleConnection(socket2);
+            // Subscribe socket1 to "coder"
+            messageHandler1(Buffer.from(JSON.stringify({ type: "subscribe", payload: { agentName: "coder" } })));
+            socket1.send.mockClear();
+            socket2.send.mockClear();
+            handler.broadcastToSubscribers("coder", { type: "pong" });
+            // socket1 subscribed, should receive
+            expect(socket1.send).toHaveBeenCalledWith(JSON.stringify({ type: "pong" }));
+            // socket2 not subscribed, should not receive
+            expect(socket2.send).not.toHaveBeenCalled();
+        });
+    });
+    describe("closeAll", () => {
+        it("closes all connected clients", async () => {
+            const handler = new WebSocketHandler(mockFleetManager);
+            const socket1 = {
+                on: vi.fn(),
+                readyState: 1,
+                OPEN: 1,
+                send: vi.fn(),
+                close: vi.fn(),
+            };
+            const socket2 = {
+                on: vi.fn(),
+                readyState: 1,
+                OPEN: 1,
+                send: vi.fn(),
+                close: vi.fn(),
+            };
+            await handler.handleConnection(socket1);
+            await handler.handleConnection(socket2);
+            expect(handler.getConnectedCount()).toBe(2);
+            handler.closeAll();
+            expect(socket1.close).toHaveBeenCalledWith(1000, "Server shutting down");
+            expect(socket2.close).toHaveBeenCalledWith(1000, "Server shutting down");
+            expect(handler.getConnectedCount()).toBe(0);
+        });
+    });
+});
+//# sourceMappingURL=ws-handler.test.js.map

package/dist/server/__tests__/ws-handler.test.js.map

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

package/dist/server/chat/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Chat module exports for @herdctl/web
+ */
+export { WebChatManager, type WebChatSession, type WebChatSessionDetails, type ChatMessage, type SendMessageResult, type OnChunkCallback, } from "./web-chat-manager.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/server/chat/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/chat/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,cAAc,EACd,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,eAAe,GACrB,MAAM,uBAAuB,CAAC"}

package/dist/server/chat/index.js

@@ -0,0 +1,5 @@
+/**
+ * Chat module exports for @herdctl/web
+ */
+export { WebChatManager, } from "./web-chat-manager.js";
+//# sourceMappingURL=index.js.map

package/dist/server/chat/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/server/chat/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,cAAc,GAMf,MAAM,uBAAuB,CAAC"}

package/dist/server/chat/web-chat-manager.d.ts

@@ -0,0 +1,158 @@
+/**
+ * Web Chat Manager for @herdctl/web
+ *
+ * Manages chat sessions for the web platform using @herdctl/chat infrastructure.
+ * Each web session maps to a unique conversation thread with an agent.
+ */
+import { type FleetManager, type WebConfig } from "@herdctl/core";
+/**
+ * Information about a web chat session
+ */
+export interface WebChatSession {
+    /** Unique session identifier */
+    sessionId: string;
+    /** Agent this session is for */
+    agentName: string;
+    /** ISO timestamp when the session was created */
+    createdAt: string;
+    /** ISO timestamp of the last message */
+    lastMessageAt: string;
+    /** Number of messages in this session */
+    messageCount: number;
+    /** Preview of the last message */
+    preview?: string;
+}
+/**
+ * A single chat message
+ */
+export interface ChatMessage {
+    /** Role of the sender */
+    role: "user" | "assistant";
+    /** Message content */
+    content: string;
+    /** ISO timestamp of the message */
+    timestamp: string;
+}
+/**
+ * Session details with full message history
+ */
+export interface WebChatSessionDetails extends WebChatSession {
+    /** All messages in this session */
+    messages: ChatMessage[];
+}
+/**
+ * Result of sending a message
+ */
+export interface SendMessageResult {
+    /** Job ID for tracking the execution */
+    jobId: string;
+    /** Whether the message was queued successfully */
+    success: boolean;
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Callback for receiving streaming chunks
+ */
+export type OnChunkCallback = (chunk: string) => void | Promise<void>;
+/**
+ * WebChatManager manages chat sessions for the web platform
+ *
+ * Uses ChatSessionManager from @herdctl/chat for per-agent session management.
+ * Message history is stored in JSON files at `.herdctl/web/chat-history/<agent>/<session>.json`
+ */
+export declare class WebChatManager {
+    private fleetManager;
+    private stateDir;
+    private sessionExpiryHours;
+    private initialized;
+    /** Per-agent session managers */
+    private sessionManagers;
+    /** In-memory session metadata cache (agentName -> sessionId -> metadata) */
+    private sessionMetadata;
+    /**
+     * Initialize the WebChatManager
+     *
+     * @param fleetManager - FleetManager instance for triggering jobs
+     * @param stateDir - State directory (e.g., ".herdctl")
+     * @param config - Web configuration from fleet config
+     */
+    initialize(fleetManager: FleetManager, stateDir: string, config: WebConfig): Promise<void>;
+    /**
+     * Create a new chat session for an agent
+     *
+     * @param agentName - Name of the agent
+     * @returns Session info with sessionId and createdAt
+     */
+    createSession(agentName: string): Promise<WebChatSession>;
+    /**
+     * List all sessions for an agent
+     *
+     * @param agentName - Name of the agent
+     * @returns Array of session summaries
+     */
+    listSessions(agentName: string): Promise<WebChatSession[]>;
+    /**
+     * Get session details with message history
+     *
+     * @param agentName - Name of the agent
+     * @param sessionId - Session ID
+     * @returns Session details with messages, or null if not found
+     */
+    getSession(agentName: string, sessionId: string): Promise<WebChatSessionDetails | null>;
+    /**
+     * Delete a session
+     *
+     * @param agentName - Name of the agent
+     * @param sessionId - Session ID
+     * @returns true if deleted, false if not found
+     */
+    deleteSession(agentName: string, sessionId: string): Promise<boolean>;
+    /**
+     * Send a message and trigger agent execution
+     *
+     * @param agentName - Name of the agent
+     * @param sessionId - Session ID
+     * @param message - User message text
+     * @param onChunk - Callback for streaming response chunks
+     * @returns Result with jobId
+     */
+    sendMessage(agentName: string, sessionId: string, message: string, onChunk: OnChunkCallback): Promise<SendMessageResult>;
+    /**
+     * Ensure the manager is initialized
+     */
+    private ensureInitialized;
+    /**
+     * Create a session manager for an agent
+     */
+    private createSessionManagerForAgent;
+    /**
+     * Get the chat history directory path
+     */
+    private getChatHistoryDir;
+    /**
+     * Get the message history file path for a session
+     */
+    private getMessageHistoryPath;
+    /**
+     * Ensure chat history directories exist
+     */
+    private ensureChatHistoryDir;
+    /**
+     * Load message history from disk
+     */
+    private loadMessageHistory;
+    /**
+     * Save message history to disk
+     */
+    private saveMessageHistory;
+    /**
+     * Delete message history file
+     */
+    private deleteMessageHistory;
+    /**
+     * Load sessions from disk into metadata cache
+     */
+    private loadSessionsFromDisk;
+}
+//# sourceMappingURL=web-chat-manager.d.ts.map

package/dist/server/chat/web-chat-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-chat-manager.d.ts","sourceRoot":"","sources":["../../../src/server/chat/web-chat-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,SAAS,EAEf,MAAM,eAAe,CAAC;AAavB;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,aAAa,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,YAAY,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,yBAAyB;IACzB,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,cAAc;IAC3D,mCAAmC;IACnC,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,OAAO,EAAE,OAAO,CAAC;IACjB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAMtE;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,kBAAkB,CAAc;IACxC,OAAO,CAAC,WAAW,CAAkB;IAErC,iCAAiC;IACjC,OAAO,CAAC,eAAe,CAA8C;IAErE,4EAA4E;IAC5E,OAAO,CAAC,eAAe,CAAuD;IAE9E;;;;;;OAMG;IACG,UAAU,CACd,YAAY,EAAE,YAAY,EAC1B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,SAAS,GAChB,OAAO,CAAC,IAAI,CAAC;IA6BhB;;;;;OAKG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IA0C/D;;;;;OAKG;IACG,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAoBhE;;;;;;OAMG;IACG,UAAU,CACd,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;IAsBxC;;;;;;OAMG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAyB3E;;;;;;;;OAQG;IACG,WAAW,CACf,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,iBAAiB,CAAC;IAsH7B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;OAEG;YACW,4BAA4B;IA0B1C;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAI7B;;OAEG;YACW,oBAAoB;IAKlC;;OAEG;YACW,kBAAkB;IAwBhC;;OAEG;YACW,kBAAkB;IAoBhC;;OAEG;YACW,oBAAoB;IAoBlC;;OAEG;YACW,oBAAoB;CA4DnC"}