agent-web-interface 4.0.0

package/dist/src/server/mcp-server.d.ts

@@ -0,0 +1,59 @@
+/**
+ * MCP Server
+ *
+ * Minimal MCP server shell for the Browser Automation MCP Server.
+ * Tool registrations will be added as the new semantic snapshot system is built.
+ */
+import type { ZodRawShape } from 'zod';
+import { type LogLevel, type McpNotificationSender } from '../shared/services/logging.service.js';
+export interface ServerConfig {
+    name: string;
+    version: string;
+}
+/**
+ * Browser Automation MCP Server
+ *
+ * Minimal shell - tool handlers will be registered by the new semantic snapshot system.
+ */
+export declare class BrowserAutomationServer implements McpNotificationSender {
+    private readonly config;
+    private server;
+    private transport;
+    constructor(config: ServerConfig);
+    /**
+     * Register a minimal ping tool
+     * This is required because McpServer only sets up tools/list handler
+     * when at least one tool is registered.
+     */
+    private registerPingTool;
+    /**
+     * Register a custom tool with the MCP server
+     */
+    registerTool(name: string, definition: {
+        title: string;
+        description?: string;
+        inputSchema: ZodRawShape;
+        outputSchema?: ZodRawShape;
+    }, handler: (input: unknown) => Promise<unknown>): void;
+    /**
+     * Send logging message notification via MCP protocol
+     */
+    sendLoggingMessage(params: {
+        level: LogLevel;
+        logger?: string;
+        data: Record<string, unknown>;
+    }): Promise<void>;
+    /**
+     * Register logging request handlers
+     */
+    private registerLoggingHandlers;
+    /**
+     * Start the MCP server
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the MCP server
+     */
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=mcp-server.d.ts.map

package/dist/src/server/mcp-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../../../src/server/mcp-server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,KAAK,CAAC;AACvC,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,qBAAqB,EAC3B,MAAM,uCAAuC,CAAC;AAG/C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,qBAAa,uBAAwB,YAAW,qBAAqB;IAIvD,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,SAAS,CAAuB;gBAEX,MAAM,EAAE,YAAY;IA8BjD;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAMxB;;OAEG;IACH,YAAY,CACV,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE;QACV,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,WAAW,CAAC;QACzB,YAAY,CAAC,EAAE,WAAW,CAAC;KAC5B,EACD,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,GAC5C,IAAI;IAuDP;;OAEG;IACG,kBAAkB,CAAC,MAAM,EAAE;QAC/B,KAAK,EAAE,QAAQ,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC/B,GAAG,OAAO,CAAC,IAAI,CAAC;IAWjB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAU/B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5B"}

package/dist/src/server/mcp-server.js

@@ -0,0 +1,140 @@
+/**
+ * MCP Server
+ *
+ * Minimal MCP server shell for the Browser Automation MCP Server.
+ * Tool registrations will be added as the new semantic snapshot system is built.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { getLogger, } from '../shared/services/logging.service.js';
+import { SetLevelRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Browser Automation MCP Server
+ *
+ * Minimal shell - tool handlers will be registered by the new semantic snapshot system.
+ */
+export class BrowserAutomationServer {
+    config;
+    server;
+    transport;
+    constructor(config) {
+        this.config = config;
+        // Create MCP server instance
+        // Note: Tools capability is auto-registered when tools are added via .tool()
+        // But logging capability must be declared explicitly for setRequestHandler to work
+        this.server = new McpServer({
+            name: config.name,
+            version: config.version,
+        }, {
+            capabilities: {
+                logging: {},
+            },
+        });
+        // Create stdio transport
+        this.transport = new StdioServerTransport();
+        // Register logging request handler
+        this.registerLoggingHandlers();
+        // Register a minimal ping tool (required for tools/list to work)
+        this.registerPingTool();
+        // Wire up logging service to MCP server
+        const logger = getLogger();
+        logger.setMcpServer(this);
+    }
+    /**
+     * Register a minimal ping tool
+     * This is required because McpServer only sets up tools/list handler
+     * when at least one tool is registered.
+     */
+    registerPingTool() {
+        this.server.tool('ping', 'Check if the server is responsive', () => ({
+            content: [{ type: 'text', text: 'pong' }],
+        }));
+    }
+    /**
+     * Register a custom tool with the MCP server
+     */
+    registerTool(name, definition, handler) {
+        this.server.registerTool(name, {
+            title: definition.title,
+            description: definition.description,
+            inputSchema: definition.inputSchema,
+            outputSchema: definition.outputSchema,
+        }, async (input) => {
+            const logger = getLogger();
+            const startTime = Date.now();
+            try {
+                logger.debug(`Executing tool: ${name}`);
+                const result = await handler(input);
+                const executionTime = Date.now() - startTime;
+                logger.debug(`Tool ${name} completed in ${executionTime}ms`);
+                // When outputSchema is defined, return structuredContent for MCP validation
+                if (definition.outputSchema) {
+                    return {
+                        content: [{ type: 'text', text: JSON.stringify(result) }],
+                        structuredContent: result,
+                    };
+                }
+                // If result is already a string (e.g., XML), use it directly
+                // Otherwise JSON.stringify it
+                const textContent = typeof result === 'string' ? result : JSON.stringify(result);
+                return {
+                    content: [{ type: 'text', text: textContent }],
+                };
+            }
+            catch (error) {
+                const executionTime = Date.now() - startTime;
+                logger.error(`Tool ${name} failed after ${executionTime}ms`, error instanceof Error ? error : undefined);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                error: error instanceof Error ? error.message : String(error),
+                            }),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        });
+    }
+    /**
+     * Send logging message notification via MCP protocol
+     */
+    async sendLoggingMessage(params) {
+        await this.server.server.notification({
+            method: 'notifications/message',
+            params: {
+                level: params.level,
+                logger: params.logger,
+                data: params.data,
+            },
+        });
+    }
+    /**
+     * Register logging request handlers
+     */
+    registerLoggingHandlers() {
+        this.server.server.setRequestHandler(SetLevelRequestSchema, (request) => {
+            const logger = getLogger();
+            const { level } = request.params;
+            logger.setMinLevel(level);
+            logger.info(`Log level set to: ${level}`);
+            return {};
+        });
+    }
+    /**
+     * Start the MCP server
+     */
+    async start() {
+        await this.server.connect(this.transport);
+        console.error(`${this.config.name} v${this.config.version} started`);
+    }
+    /**
+     * Stop the MCP server
+     */
+    async stop() {
+        await this.server.close();
+    }
+}
+//# sourceMappingURL=mcp-server.js.map

package/dist/src/server/mcp-server.js.map

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

package/dist/src/server/server-config.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Server Configuration
+ *
+ * Global server configuration combining CLI args and environment variables.
+ * Provides the ensureBrowserForTools function that tool handlers call.
+ */
+import { type ServerArgs } from '../cli/args.js';
+import { SessionManager } from '../browser/session-manager.js';
+/**
+ * Initialize server configuration from CLI arguments and environment variables.
+ *
+ * @param argv - Command line arguments (process.argv.slice(2))
+ */
+export declare function initServerConfig(argv: string[]): void;
+/**
+ * Get the current server configuration.
+ * Throws if not initialized.
+ */
+export declare function getServerConfig(): ServerArgs;
+/**
+ * Get or create the SessionManager singleton.
+ */
+export declare function getSessionManager(): SessionManager;
+/**
+ * Check if the SessionManager has been initialized.
+ * Use this before calling getSessionManager() in cleanup paths
+ * to avoid creating a new instance unnecessarily.
+ */
+export declare function isSessionManagerInitialized(): boolean;
+/**
+ * Ensure browser is ready for tool execution.
+ *
+ * This is the main entry point for tools to call before executing.
+ * It will lazily launch or connect to a browser based on server configuration.
+ */
+export declare function ensureBrowserForTools(): Promise<void>;
+/**
+ * Reset server state (for testing).
+ */
+export declare function resetServerState(): void;
+//# sourceMappingURL=server-config.d.ts.map

package/dist/src/server/server-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-config.d.ts","sourceRoot":"","sources":["../../../src/server/server-config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAa,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAO/D;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAUrD;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,UAAU,CAK5C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAGlD;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,IAAI,OAAO,CAErD;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAgB3D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAGvC"}

package/dist/src/server/server-config.js

@@ -0,0 +1,80 @@
+/**
+ * Server Configuration
+ *
+ * Global server configuration combining CLI args and environment variables.
+ * Provides the ensureBrowserForTools function that tool handlers call.
+ */
+import { parseArgs } from '../cli/args.js';
+import { SessionManager } from '../browser/session-manager.js';
+import { ensureBrowserReady } from '../browser/ensure-browser.js';
+// Singleton instances
+let serverConfig = null;
+let sessionManager = null;
+/**
+ * Initialize server configuration from CLI arguments and environment variables.
+ *
+ * @param argv - Command line arguments (process.argv.slice(2))
+ */
+export function initServerConfig(argv) {
+    const args = parseArgs(argv);
+    // Apply environment variable overrides
+    // Only enable autoConnect from env if no explicit browserUrl/wsEndpoint was provided
+    if (process.env.AUTO_CONNECT === 'true' && !args.browserUrl && !args.wsEndpoint) {
+        args.autoConnect = true;
+    }
+    serverConfig = args;
+}
+/**
+ * Get the current server configuration.
+ * Throws if not initialized.
+ */
+export function getServerConfig() {
+    if (!serverConfig) {
+        throw new Error('Server config not initialized. Call initServerConfig() first.');
+    }
+    return serverConfig;
+}
+/**
+ * Get or create the SessionManager singleton.
+ */
+export function getSessionManager() {
+    sessionManager ??= new SessionManager();
+    return sessionManager;
+}
+/**
+ * Check if the SessionManager has been initialized.
+ * Use this before calling getSessionManager() in cleanup paths
+ * to avoid creating a new instance unnecessarily.
+ */
+export function isSessionManagerInitialized() {
+    return sessionManager !== null;
+}
+/**
+ * Ensure browser is ready for tool execution.
+ *
+ * This is the main entry point for tools to call before executing.
+ * It will lazily launch or connect to a browser based on server configuration.
+ */
+export async function ensureBrowserForTools() {
+    const config = getServerConfig();
+    const session = getSessionManager();
+    const options = {
+        headless: config.headless,
+        isolated: config.isolated,
+        browserUrl: config.browserUrl,
+        wsEndpoint: config.wsEndpoint,
+        autoConnect: config.autoConnect,
+        userDataDir: config.userDataDir,
+        channel: config.channel,
+        executablePath: config.executablePath,
+    };
+    await ensureBrowserReady(session, options);
+}
+/**
+ * Reset server state (for testing).
+ */
+export function resetServerState() {
+    serverConfig = null;
+    sessionManager = null;
+}
+//# sourceMappingURL=server-config.js.map

package/dist/src/server/server-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-config.js","sourceRoot":"","sources":["../../../src/server/server-config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAmB,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAA6B,MAAM,8BAA8B,CAAC;AAE7F,sBAAsB;AACtB,IAAI,YAAY,GAAsB,IAAI,CAAC;AAC3C,IAAI,cAAc,GAA0B,IAAI,CAAC;AAEjD;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAc;IAC7C,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAE7B,uCAAuC;IACvC,qFAAqF;IACrF,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;QAChF,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED,YAAY,GAAG,IAAI,CAAC;AACtB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe;IAC7B,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;IACnF,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,cAAc,KAAK,IAAI,cAAc,EAAE,CAAC;IACxC,OAAO,cAAc,CAAC;AACxB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,2BAA2B;IACzC,OAAO,cAAc,KAAK,IAAI,CAAC;AACjC,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB;IACzC,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;IACjC,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAC;IAEpC,MAAM,OAAO,GAAyB;QACpC,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,cAAc,EAAE,MAAM,CAAC,cAAc;KACtC,CAAC;IAEF,MAAM,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,YAAY,GAAG,IAAI,CAAC;IACpB,cAAc,GAAG,IAAI,CAAC;AACxB,CAAC"}

package/dist/src/server/session-store.d.ts

@@ -0,0 +1,148 @@
+/**
+ * Session Store
+ *
+ * Tracks active sessions per MCP client (tenant isolation).
+ * Supports optional TTL-based auto-cleanup of expired sessions.
+ */
+/**
+ * Options for session store configuration
+ */
+export interface SessionStoreOptions {
+    /** Session TTL in milliseconds (default: 30 minutes, 0 = no expiry) */
+    ttlMs?: number;
+    /** Maximum sessions allowed (default: unlimited) */
+    maxSessions?: number;
+    /** Enable automatic cleanup of expired sessions (default: false) */
+    autoCleanup?: boolean;
+}
+/**
+ * Represents a tenant session
+ */
+export interface TenantSession {
+    /** Unique session identifier */
+    session_id: string;
+    /** Tenant/client identifier */
+    tenant_id: string;
+    /** Page IDs associated with this session */
+    page_ids: Set<string>;
+    /** When the session was created */
+    created_at: Date;
+    /** When the session was last accessed */
+    last_accessed_at: Date;
+    /** When the session expires (null = never) */
+    expires_at: Date | null;
+}
+/**
+ * In-memory session store for tenant isolation
+ */
+export declare class SessionStore {
+    private readonly sessions;
+    private readonly ttlMs;
+    private readonly maxSessions;
+    private cleanupInterval;
+    constructor(options?: SessionStoreOptions);
+    /**
+     * Create a new session for a tenant
+     *
+     * @param tenant_id - The tenant/client identifier
+     * @returns The new session_id
+     * @throws Error if max sessions limit reached
+     */
+    createSession(tenant_id: string): string;
+    /**
+     * Get a session by its ID.
+     * Automatically refreshes TTL and checks for expiration.
+     *
+     * @param session_id - The session identifier
+     * @returns TenantSession if found and not expired, undefined otherwise
+     */
+    getSession(session_id: string): TenantSession | undefined;
+    /**
+     * Add a page to a session
+     *
+     * @param session_id - The session identifier
+     * @param page_id - The page identifier to add
+     */
+    addPage(session_id: string, page_id: string): void;
+    /**
+     * Remove a page from a session
+     *
+     * @param session_id - The session identifier
+     * @param page_id - The page identifier to remove
+     */
+    removePage(session_id: string, page_id: string): void;
+    /**
+     * Get all pages for a session
+     *
+     * @param session_id - The session identifier
+     * @returns Array of page_ids (empty if session not found)
+     */
+    getPages(session_id: string): string[];
+    /**
+     * Destroy a session completely
+     *
+     * @param session_id - The session identifier
+     */
+    destroySession(session_id: string): void;
+    /**
+     * List all active sessions
+     *
+     * @returns Array of all TenantSession objects
+     */
+    listSessions(): TenantSession[];
+    /**
+     * Get sessions for a specific tenant
+     *
+     * @param tenant_id - The tenant identifier
+     * @returns Array of sessions for this tenant
+     */
+    getSessionsByTenant(tenant_id: string): TenantSession[];
+    /**
+     * Get the total number of sessions
+     *
+     * @returns Session count
+     */
+    sessionCount(): number;
+    /**
+     * Check if a session exists
+     *
+     * @param session_id - The session identifier
+     * @returns true if session exists
+     */
+    hasSession(session_id: string): boolean;
+    /**
+     * Clear all sessions (for testing or shutdown)
+     */
+    clear(): void;
+    /**
+     * Stop automatic cleanup timer
+     */
+    stopAutoCleanup(): void;
+    /**
+     * Start automatic cleanup of expired sessions
+     */
+    startAutoCleanup(): void;
+    /**
+     * Manually clean up all expired sessions
+     *
+     * @returns Number of sessions removed
+     */
+    cleanupExpired(): number;
+    /**
+     * Check if a session is expired
+     */
+    private isExpired;
+    /**
+     * Touch a session to refresh its TTL
+     */
+    private touchSession;
+    /**
+     * Get the configured TTL in milliseconds
+     */
+    getTtlMs(): number;
+    /**
+     * Get the configured max sessions limit
+     */
+    getMaxSessions(): number;
+}
+//# sourceMappingURL=session-store.d.ts.map

package/dist/src/server/session-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-store.d.ts","sourceRoot":"","sources":["../../../src/server/session-store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,oEAAoE;IACpE,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IAEnB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAElB,4CAA4C;IAC5C,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAEtB,mCAAmC;IACnC,UAAU,EAAE,IAAI,CAAC;IAEjB,yCAAyC;IACzC,gBAAgB,EAAE,IAAI,CAAC;IAEvB,8CAA8C;IAC9C,UAAU,EAAE,IAAI,GAAG,IAAI,CAAC;CACzB;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoC;IAC7D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,eAAe,CAA+B;gBAE1C,OAAO,GAAE,mBAAwB;IAS7C;;;;;;OAMG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAuBxC;;;;;;OAMG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAezD;;;;;OAKG;IACH,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAOlD;;;;;OAKG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAOrD;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE;IAQtC;;;;OAIG;IACH,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAIxC;;;;OAIG;IACH,YAAY,IAAI,aAAa,EAAE;IAI/B;;;;;OAKG;IACH,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,EAAE;IAIvD;;;;OAIG;IACH,YAAY,IAAI,MAAM;IAItB;;;;;OAKG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAIvC;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,eAAe,IAAI,IAAI;IAOvB;;OAEG;IACH,gBAAgB,IAAI,IAAI;IAUxB;;;;OAIG;IACH,cAAc,IAAI,MAAM;IAcxB;;OAEG;IACH,OAAO,CAAC,SAAS;IAKjB;;OAEG;IACH,OAAO,CAAC,YAAY;IAQpB;;OAEG;IACH,QAAQ,IAAI,MAAM;IAIlB;;OAEG;IACH,cAAc,IAAI,MAAM;CAGzB"}