@clawswarm/bridge 0.1.0-alpha

package/README.md

@@ -0,0 +1,68 @@
+# @clawswarm/bridge
+
+WebSocket bridge server for ClawSwarm — enables real-time communication between agents, UI clients, and external services.
+
+## Features
+
+- 🔌 **WebSocket server** — persistent connections for agents and dashboard clients
+- 🏢 **Org-scoped routing** — tasks and events are isolated per organization
+- 📡 **Real-time events** — task updates, agent status, and goal progress streamed live
+- 🔐 **Token-based auth** — per-connection authentication via Bearer tokens
+- 🔁 **Reconnect handling** — automatic ping/pong and stale connection cleanup
+
+## Installation
+
+```bash
+npm install @clawswarm/bridge
+```
+
+## Usage
+
+### Standalone Server
+
+```typescript
+import { BridgeServer } from '@clawswarm/bridge';
+
+const bridge = new BridgeServer({ port: 8787, host: '0.0.0.0' });
+await bridge.start();
+
+bridge.on('client:connected', (client) => {
+  console.log('New client:', client.id, 'org:', client.orgId);
+});
+```
+
+### With ClawSwarm Core
+
+```typescript
+import { ClawSwarm, Agent } from '@clawswarm/core';
+import { BridgeServer, TaskRouter } from '@clawswarm/bridge';
+
+const bridge = new BridgeServer({ port: 8787 });
+await bridge.start();
+
+const router = new TaskRouter(bridge);
+
+const swarm = new ClawSwarm({
+  agents: [Agent.research({ model: 'claude-sonnet-4' })],
+  bridgeUrl: 'ws://localhost:8787',
+});
+
+// Forward swarm events to bridge clients
+swarm.on('task:completed', (task) => {
+  router.broadcast(task.goalId, { type: 'task:completed', payload: task });
+});
+```
+
+## Configuration
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `port` | `number` | `8787` | Port to listen on |
+| `host` | `string` | `'0.0.0.0'` | Host to bind to |
+| `maxConnections` | `number` | `1000` | Max concurrent WebSocket connections |
+| `pingIntervalMs` | `number` | `30000` | Ping interval for keep-alive |
+| `authTokens` | `string[]` | `[]` | Allowed auth tokens (empty = no auth) |
+
+## License
+
+MIT

package/dist/bridge.d.ts

@@ -0,0 +1,105 @@
+/**
+ * WebSocket bridge server for ClawSwarm.
+ *
+ * Provides real-time bidirectional communication between agents,
+ * dashboard clients, and external consumers. Handles org-scoped
+ * message routing, authentication, and connection lifecycle.
+ *
+ * @module @clawswarm/bridge/bridge
+ */
+import EventEmitter from 'eventemitter3';
+import { BridgeClient, BridgeMessage, BridgeServerConfig, BridgeServerEvents } from './types.js';
+declare const BridgeServer_base: new () => EventEmitter<BridgeServerEvents>;
+/**
+ * The ClawSwarm bridge server.
+ *
+ * Manages WebSocket connections, authenticates clients, and routes
+ * messages between agents and dashboard consumers within org boundaries.
+ *
+ * @example
+ * ```typescript
+ * const bridge = new BridgeServer({ port: 8787 });
+ *
+ * bridge.on('client:connected', (client) => {
+ *   console.log('Connected:', client.id, 'org:', client.orgId);
+ * });
+ *
+ * await bridge.start();
+ * console.log('Bridge listening on ws://localhost:8787');
+ * ```
+ */
+export declare class BridgeServer extends BridgeServer_base {
+    private readonly config;
+    private wss;
+    private clients;
+    private pingTimer;
+    constructor(config?: BridgeServerConfig);
+    /**
+     * Start the WebSocket server.
+     * Returns a promise that resolves once the server is listening.
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the WebSocket server and disconnect all clients.
+     */
+    stop(): Promise<void>;
+    /**
+     * Send a message to a specific client by ID.
+     * Returns false if the client is not found or not connected.
+     */
+    send(clientId: string, message: BridgeMessage): boolean;
+    /**
+     * Broadcast a message to all clients in an organization.
+     * Optionally filter by role.
+     *
+     * @param orgId - Organization to broadcast to ('*' for all orgs)
+     * @param message - Message to send
+     * @param roles - Optional role filter
+     * @returns Number of clients reached
+     */
+    broadcast(orgId: string, message: BridgeMessage, roles?: BridgeClient['role'][]): number;
+    /**
+     * Get all connected clients (optionally filtered by org).
+     */
+    getClients(orgId?: string): BridgeClient[];
+    /**
+     * Get server stats.
+     */
+    stats(): {
+        connections: number;
+        orgs: number;
+        uptime: boolean;
+    };
+    /**
+     * Handle a new WebSocket connection.
+     * @internal
+     */
+    private _onConnection;
+    /**
+     * Handle an incoming message from a client.
+     * @internal
+     */
+    private _onMessage;
+    /**
+     * Handle an auth message from a client.
+     * @internal
+     */
+    private _handleAuth;
+    /**
+     * Handle a client disconnection.
+     * @internal
+     */
+    private _onClose;
+    /**
+     * Build an error message.
+     * @internal
+     */
+    private _errorMessage;
+    /**
+     * Start the ping timer for keep-alive.
+     * @internal
+     */
+    private _startPingTimer;
+}
+export {};
+//# sourceMappingURL=bridge.d.ts.map

package/dist/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,YAAY,MAAM,eAAe,CAAC;AACzC,OAAO,EACL,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAEnB,MAAM,YAAY,CAAC;iCA6B+B,UAAU,YAAY,CAAC,kBAAkB,CAAC;AAlB7F;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,YAAa,SAAQ,iBAA4D;IAC5F,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+B;IACtD,OAAO,CAAC,GAAG,CAAgC;IAC3C,OAAO,CAAC,OAAO,CAAuE;IACtF,OAAO,CAAC,SAAS,CAA+C;gBAEpD,MAAM,GAAE,kBAAuB;IAc3C;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAsB3B;;;OAGG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO;IAavD;;;;;;;;OAQG;IACH,SAAS,CACP,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,aAAa,EACtB,KAAK,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,GAC7B,MAAM;IAcT;;OAEG;IACH,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE;IAK1C;;OAEG;IACH,KAAK,IAAI;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE;IAW/D;;;OAGG;IACH,OAAO,CAAC,aAAa;IA4BrB;;;OAGG;IACH,OAAO,CAAC,UAAU;IAiClB;;;OAGG;IACH,OAAO,CAAC,WAAW;IA8BnB;;;OAGG;IACH,OAAO,CAAC,QAAQ;IAKhB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAQrB;;;OAGG;IACH,OAAO,CAAC,eAAe;CAcxB"}

package/dist/bridge.js

@@ -0,0 +1,297 @@
+"use strict";
+/**
+ * WebSocket bridge server for ClawSwarm.
+ *
+ * Provides real-time bidirectional communication between agents,
+ * dashboard clients, and external consumers. Handles org-scoped
+ * message routing, authentication, and connection lifecycle.
+ *
+ * @module @clawswarm/bridge/bridge
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BridgeServer = void 0;
+const ws_1 = require("ws");
+const uuid_1 = require("uuid");
+const eventemitter3_1 = __importDefault(require("eventemitter3"));
+// ─── Defaults ─────────────────────────────────────────────────────────────────
+const DEFAULT_PORT = 8787;
+const DEFAULT_HOST = '0.0.0.0';
+const DEFAULT_MAX_CONNECTIONS = 1000;
+const DEFAULT_PING_INTERVAL_MS = 30_000;
+// ─── BridgeServer ─────────────────────────────────────────────────────────────
+/**
+ * The ClawSwarm bridge server.
+ *
+ * Manages WebSocket connections, authenticates clients, and routes
+ * messages between agents and dashboard consumers within org boundaries.
+ *
+ * @example
+ * ```typescript
+ * const bridge = new BridgeServer({ port: 8787 });
+ *
+ * bridge.on('client:connected', (client) => {
+ *   console.log('Connected:', client.id, 'org:', client.orgId);
+ * });
+ *
+ * await bridge.start();
+ * console.log('Bridge listening on ws://localhost:8787');
+ * ```
+ */
+class BridgeServer extends eventemitter3_1.default {
+    config;
+    wss = null;
+    clients = new Map();
+    pingTimer = null;
+    constructor(config = {}) {
+        super();
+        this.config = {
+            port: config.port ?? DEFAULT_PORT,
+            host: config.host ?? DEFAULT_HOST,
+            maxConnections: config.maxConnections ?? DEFAULT_MAX_CONNECTIONS,
+            pingIntervalMs: config.pingIntervalMs ?? DEFAULT_PING_INTERVAL_MS,
+            authTokens: config.authTokens ?? [],
+            path: config.path ?? '/',
+        };
+    }
+    // ─── Public API ───────────────────────────────────────────────────────────
+    /**
+     * Start the WebSocket server.
+     * Returns a promise that resolves once the server is listening.
+     */
+    async start() {
+        if (this.wss)
+            throw new Error('BridgeServer is already running');
+        return new Promise((resolve, reject) => {
+            this.wss = new ws_1.WebSocketServer({
+                port: this.config.port,
+                host: this.config.host,
+                path: this.config.path,
+            });
+            this.wss.on('connection', (socket, req) => this._onConnection(socket, req));
+            this.wss.on('error', (err) => {
+                this.emit('error', err);
+                reject(err);
+            });
+            this.wss.on('listening', () => {
+                this._startPingTimer();
+                this.emit('listening', this.config.port, this.config.host);
+                resolve();
+            });
+        });
+    }
+    /**
+     * Stop the WebSocket server and disconnect all clients.
+     */
+    async stop() {
+        if (!this.wss)
+            return;
+        if (this.pingTimer) {
+            clearInterval(this.pingTimer);
+            this.pingTimer = null;
+        }
+        // Close all client connections
+        for (const [id, { socket }] of this.clients) {
+            socket.close(1001, 'Server shutting down');
+            this.clients.delete(id);
+        }
+        return new Promise((resolve) => {
+            this.wss.close(() => {
+                this.wss = null;
+                resolve();
+            });
+        });
+    }
+    /**
+     * Send a message to a specific client by ID.
+     * Returns false if the client is not found or not connected.
+     */
+    send(clientId, message) {
+        const entry = this.clients.get(clientId);
+        if (!entry || entry.socket.readyState !== ws_1.WebSocket.OPEN)
+            return false;
+        try {
+            entry.socket.send(JSON.stringify(message));
+            this.emit('message:sent', clientId, message);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Broadcast a message to all clients in an organization.
+     * Optionally filter by role.
+     *
+     * @param orgId - Organization to broadcast to ('*' for all orgs)
+     * @param message - Message to send
+     * @param roles - Optional role filter
+     * @returns Number of clients reached
+     */
+    broadcast(orgId, message, roles) {
+        let count = 0;
+        for (const [, { client, socket }] of this.clients) {
+            if (socket.readyState !== ws_1.WebSocket.OPEN)
+                continue;
+            if (orgId !== '*' && client.orgId !== orgId)
+                continue;
+            if (roles && !roles.includes(client.role))
+                continue;
+            if (!client.authenticated)
+                continue;
+            socket.send(JSON.stringify(message));
+            count++;
+        }
+        return count;
+    }
+    /**
+     * Get all connected clients (optionally filtered by org).
+     */
+    getClients(orgId) {
+        const all = Array.from(this.clients.values()).map(e => e.client);
+        return orgId ? all.filter(c => c.orgId === orgId) : all;
+    }
+    /**
+     * Get server stats.
+     */
+    stats() {
+        const orgs = new Set(Array.from(this.clients.values()).map(e => e.client.orgId));
+        return {
+            connections: this.clients.size,
+            orgs: orgs.size,
+            uptime: this.wss !== null,
+        };
+    }
+    // ─── Private ──────────────────────────────────────────────────────────────
+    /**
+     * Handle a new WebSocket connection.
+     * @internal
+     */
+    _onConnection(socket, _req) {
+        if (this.clients.size >= this.config.maxConnections) {
+            socket.close(1013, 'Server at capacity');
+            return;
+        }
+        const clientId = (0, uuid_1.v4)();
+        const client = {
+            id: clientId,
+            orgId: 'unknown',
+            role: 'external',
+            connectedAt: new Date().toISOString(),
+            authenticated: this.config.authTokens.length === 0, // no auth if no tokens configured
+            metadata: {},
+        };
+        this.clients.set(clientId, { client, socket });
+        this.emit('client:connected', client);
+        socket.on('message', (data) => this._onMessage(clientId, data));
+        socket.on('close', (code, reason) => this._onClose(clientId, code, reason.toString()));
+        socket.on('error', (err) => this.emit('error', err));
+        socket.on('pong', () => {
+            const entry = this.clients.get(clientId);
+            if (entry)
+                entry.client.lastPingAt = new Date().toISOString();
+        });
+    }
+    /**
+     * Handle an incoming message from a client.
+     * @internal
+     */
+    _onMessage(clientId, data) {
+        const entry = this.clients.get(clientId);
+        if (!entry)
+            return;
+        let message;
+        try {
+            message = JSON.parse(data.toString());
+        }
+        catch {
+            this.send(clientId, this._errorMessage('PARSE_ERROR', 'Invalid JSON'));
+            return;
+        }
+        // Handle auth message
+        if (message.type === 'auth') {
+            this._handleAuth(clientId, message.payload);
+            return;
+        }
+        // Reject unauthenticated messages
+        if (!entry.client.authenticated) {
+            this.send(clientId, this._errorMessage('UNAUTHORIZED', 'Authenticate first'));
+            return;
+        }
+        // Handle ping
+        if (message.type === 'ping') {
+            this.send(clientId, { type: 'pong', ts: new Date().toISOString(), payload: {} });
+            return;
+        }
+        this.emit('message:received', entry.client, message);
+    }
+    /**
+     * Handle an auth message from a client.
+     * @internal
+     */
+    _handleAuth(clientId, payload) {
+        const entry = this.clients.get(clientId);
+        if (!entry)
+            return;
+        const { token, orgId, role, metadata } = payload;
+        // Validate token if auth is configured
+        if (this.config.authTokens.length > 0 &&
+            !this.config.authTokens.includes(token)) {
+            this.send(clientId, this._errorMessage('INVALID_TOKEN', 'Invalid auth token'));
+            entry.socket.close(1008, 'Unauthorized');
+            return;
+        }
+        entry.client.authenticated = true;
+        entry.client.orgId = orgId;
+        entry.client.role = role;
+        entry.client.metadata = metadata ?? {};
+        this.send(clientId, {
+            type: 'pong', // using pong as ack
+            ts: new Date().toISOString(),
+            payload: { authenticated: true, clientId },
+        });
+        this.emit('client:authenticated', entry.client);
+    }
+    /**
+     * Handle a client disconnection.
+     * @internal
+     */
+    _onClose(clientId, code, reason) {
+        this.clients.delete(clientId);
+        this.emit('client:disconnected', clientId, reason || String(code));
+    }
+    /**
+     * Build an error message.
+     * @internal
+     */
+    _errorMessage(code, message) {
+        return {
+            type: 'error',
+            ts: new Date().toISOString(),
+            payload: { code, message },
+        };
+    }
+    /**
+     * Start the ping timer for keep-alive.
+     * @internal
+     */
+    _startPingTimer() {
+        this.pingTimer = setInterval(() => {
+            const now = new Date().toISOString();
+            for (const [id, { socket, client }] of this.clients) {
+                if (socket.readyState === ws_1.WebSocket.OPEN) {
+                    socket.ping();
+                    client.lastPingAt = now;
+                }
+                else {
+                    // Clean up stale connections
+                    this.clients.delete(id);
+                }
+            }
+        }, this.config.pingIntervalMs);
+    }
+}
+exports.BridgeServer = BridgeServer;
+//# sourceMappingURL=bridge.js.map

package/dist/bridge.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @clawswarm/bridge — Public API
+ *
+ * @example
+ * ```typescript
+ * import { BridgeServer, TaskRouter } from '@clawswarm/bridge';
+ * ```
+ *
+ * @module @clawswarm/bridge
+ */
+export { BridgeServer } from './bridge.js';
+export { TaskRouter } from './router.js';
+export type { BridgeClient, ClientRole, BridgeMessage, BridgeMessageType, BridgeServerConfig, BridgeServerEvents, AuthPayload, ErrorPayload, AgentStatusPayload, RoutingRule, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,YAAY,EACV,YAAY,EACZ,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,WAAW,GACZ,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,18 @@
+"use strict";
+/**
+ * @clawswarm/bridge — Public API
+ *
+ * @example
+ * ```typescript
+ * import { BridgeServer, TaskRouter } from '@clawswarm/bridge';
+ * ```
+ *
+ * @module @clawswarm/bridge
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TaskRouter = exports.BridgeServer = void 0;
+var bridge_js_1 = require("./bridge.js");
+Object.defineProperty(exports, "BridgeServer", { enumerable: true, get: function () { return bridge_js_1.BridgeServer; } });
+var router_js_1 = require("./router.js");
+Object.defineProperty(exports, "TaskRouter", { enumerable: true, get: function () { return router_js_1.TaskRouter; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAEH,yCAA2C;AAAlC,yGAAA,YAAY,OAAA;AACrB,yCAAyC;AAAhC,uGAAA,UAAU,OAAA"}

package/dist/router.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Org-scoped task router for the ClawSwarm bridge.
+ *
+ * Routes messages from ClawSwarm events to the appropriate
+ * WebSocket clients based on organization ID and client role.
+ *
+ * @module @clawswarm/bridge/router
+ */
+import { BridgeServer } from './bridge.js';
+import { BridgeMessage, BridgeMessageType, ClientRole } from './types.js';
+/**
+ * Routes ClawSwarm events to connected bridge clients.
+ *
+ * Provides a high-level API for broadcasting goal/task events
+ * to the right clients within an organization.
+ *
+ * @example
+ * ```typescript
+ * const bridge = new BridgeServer({ port: 8787 });
+ * await bridge.start();
+ *
+ * const router = new TaskRouter(bridge);
+ *
+ * // Connect a ClawSwarm instance to the router
+ * swarm.on('task:completed', (task) => {
+ *   router.routeTaskEvent('task:completed', task.goalId, task, 'my-org-id');
+ * });
+ * ```
+ */
+export declare class TaskRouter {
+    private readonly bridge;
+    private readonly rules;
+    constructor(bridge: BridgeServer);
+    /**
+     * Route a task-related event to all dashboard clients in the org.
+     *
+     * @param type - Event type
+     * @param goalId - Goal ID for context
+     * @param payload - Event payload
+     * @param orgId - Organization to route to
+     */
+    routeTaskEvent(type: BridgeMessageType, goalId: string, payload: unknown, orgId: string): number;
+    /**
+     * Route a goal-related event.
+     *
+     * @param type - Event type
+     * @param payload - Event payload (the Goal object)
+     * @param orgId - Organization to route to
+     */
+    routeGoalEvent(type: BridgeMessageType, payload: unknown, orgId: string): number;
+    /**
+     * Route an agent status update to dashboard clients.
+     */
+    routeAgentStatus(agentId: string, agentType: string, status: 'idle' | 'busy' | 'error' | 'offline', orgId: string, currentTaskId?: string): number;
+    /**
+     * Broadcast a raw message to all clients in an org.
+     */
+    broadcast(orgId: string, message: BridgeMessage, roles?: ClientRole[]): number;
+    /**
+     * Add a routing rule for custom message handling.
+     * Rules are evaluated before default routing.
+     *
+     * @param id - Unique rule identifier
+     * @param rule - Route rule definition
+     */
+    addRule(id: string, rule: RouteRule): void;
+    /**
+     * Remove a routing rule.
+     */
+    removeRule(id: string): boolean;
+    /**
+     * Route a message through all matching rules.
+     * Returns the number of clients that received the message.
+     */
+    route(orgId: string, message: BridgeMessage): number;
+    /**
+     * Build a typed bridge message.
+     * @internal
+     */
+    private _buildMessage;
+}
+interface RouteRule {
+    messageType: BridgeMessageType | '*';
+    orgIds?: string[];
+    roles?: ClientRole[];
+}
+export {};
+//# sourceMappingURL=router.d.ts.map

package/dist/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAI1E;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqC;gBAE/C,MAAM,EAAE,YAAY;IAMhC;;;;;;;OAOG;IACH,cAAc,CACZ,IAAI,EAAE,iBAAiB,EACvB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,MAAM,GACZ,MAAM;IAQT;;;;;;OAMG;IACH,cAAc,CACZ,IAAI,EAAE,iBAAiB,EACvB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,MAAM,GACZ,MAAM;IAQT;;OAEG;IACH,gBAAgB,CACd,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,EAC7C,KAAK,EAAE,MAAM,EACb,aAAa,CAAC,EAAE,MAAM,GACrB,MAAM;IAQT;;OAEG;IACH,SAAS,CACP,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,aAAa,EACtB,KAAK,CAAC,EAAE,UAAU,EAAE,GACnB,MAAM;IAIT;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI;IAI1C;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI/B;;;OAGG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM;IAoBpD;;;OAGG;IACH,OAAO,CAAC,aAAa;CAYtB;AAID,UAAU,SAAS;IACjB,WAAW,EAAE,iBAAiB,GAAG,GAAG,CAAC;IACrC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;CACtB"}