@bundy-lmw/hive-server 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 bundy-lmw
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,211 @@
+# @bundy-lmw/hive-server
+
+Hive 多 Agent 协作框架的服务器应用。
+
+## 安装
+
+```bash
+pnpm install
+pnpm build
+```
+
+## 配置
+
+### 方式一：使用 hive.config.json（推荐）
+
+创建 `hive.config.json` 文件：
+
+```json
+{
+  "server": {
+    "port": 3000,
+    "logLevel": "info"
+  },
+  "provider": {
+    "id": "glm",
+    "apiKey": "${GLM_API_KEY}",
+    "model": "glm-4-plus"
+  },
+  "plugins": {
+    "@bundy-lmw/hive-plugin-feishu": {
+      "apps": [
+        {
+          "appId": "${FEISHU_APP_ID}",
+          "appSecret": "${FEISHU_APP_SECRET}"
+        }
+      ]
+    }
+  }
+}
+```
+
+环境变量使用 `${VAR_NAME}` 语法，会自动从系统环境变量中读取。
+
+## 使用
+
+### CLI 命令
+
+```bash
+# 查看帮助
+hive --help
+
+# 查看版本
+hive --version
+
+# 启动交互式聊天
+hive chat
+
+# 启动 HTTP/WebSocket 服务器
+hive server
+
+# 指定端口启动
+hive server --port 8080
+```
+
+### HTTP API
+
+服务器启动后，提供以下端点：
+
+| 端点 | 方法 | 描述 |
+|------|------|------|
+| `/health` | GET | 健康检查 |
+| `/api/chat` | POST | 发送聊天消息 |
+| `/api/sessions` | GET | 获取会话列表 |
+| `/api/sessions/:id` | GET | 获取会话详情 |
+| `/webhook/:plugin/:appId` | POST | 插件 Webhook |
+
+#### 聊天示例
+
+```bash
+curl -X POST http://localhost:3000/api/chat \
+  -H "Content-Type: application/json" \
+  -d '{"message": "你好"}'
+```
+
+### WebSocket
+
+连接到 `ws://localhost:3000/ws` 进行实时通信：
+
+```javascript
+const ws = new WebSocket('ws://localhost:3000/ws')
+
+ws.onopen = () => {
+  ws.send(JSON.stringify({ type: 'chat', message: '你好' }))
+}
+
+ws.onmessage = (event) => {
+  console.log(JSON.parse(event.data))
+}
+```
+
+## 插件系统
+
+Hive 支持通过插件扩展通道能力。
+
+### 配置插件
+
+在 `hive.config.json` 中配置插件：
+
+```json
+{
+  "plugins": {
+    "@bundy-lmw/hive-plugin-feishu": {
+      "apps": [
+        {
+          "appId": "cli_xxxxxx",
+          "appSecret": "xxxxxx"
+        }
+      ]
+    }
+  }
+}
+```
+
+### Webhook 配置
+
+对于飞书等需要接收事件的平台，配置 Webhook URL：
+
+```
+https://your-server.com/webhook/feishu/{appId}
+```
+
+### 开发插件
+
+创建新插件需要实现 `IPlugin` 接口：
+
+```typescript
+import type { IPlugin, IChannel, PluginContext } from '@bundy-lmw/hive-core'
+
+export class MyPlugin implements IPlugin {
+  readonly metadata = {
+    id: 'my-plugin',
+    name: 'My Plugin',
+    version: '1.0.0'
+  }
+
+  async initialize(context: PluginContext): Promise<void> {
+    // 初始化逻辑
+  }
+
+  async activate(): Promise<void> {
+    // 激活插件
+  }
+
+  async deactivate(): Promise<void> {
+    // 停用插件
+  }
+
+  getChannels(): IChannel[] {
+    // 返回通道列表
+    return []
+  }
+}
+```
+
+## 架构
+
+```
+┌─────────────────────────────────────────────────────┐
+│                    CLI Entry                        │
+│                 (src/cli/index.ts)                  │
+└───────────────────────┬─────────────────────────────┘
+                        │
+┌───────────────────────▼─────────────────────────────┐
+│                    Bootstrap                        │
+│                 (src/bootstrap.ts)                  │
+│  ┌─────────┐  ┌────────┐                            │
+│  │Agent    │  │Message │                            │
+│  │         │  │Bus     │                            │
+│  └────┬────┘  └────┬───┘                            │
+└───────┼────────────┼────────────────────────────────┘
+        │            │
+┌───────▼────────────▼─────────────────────────────────┐
+│                   Gateways                          │
+│  ┌─────────────────────┐  ┌──────────────────────┐  │
+│  │HTTP (Hono)          │  │WebSocket             │  │
+│  │- /api/chat          │  │- Real-time chat      │  │
+│  │- /api/sessions      │  │- Event streaming     │  │
+│  └─────────────────────┘  └──────────────────────┘  │
+└─────────────────────────────────────────────────────┘
+```
+
+## 开发
+
+```bash
+# 监视模式构建
+pnpm dev
+
+# 运行测试
+pnpm test
+
+# 测试监视模式
+pnpm test:watch
+```
+
+## GitHub
+
+[https://github.com/1695365384/hive](https://github.com/1695365384/hive)
+
+## 许可证
+
+MIT

package/dist/bootstrap.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Hive Server Bootstrap
+ *
+ * Thin wrapper around createServer() that reads ServerConfig and
+ * returns a HiveContext compatible with the existing API surface.
+ */
+import { type Agent, type IPlugin, type ILogger, type Server, type MessageBus } from '@bundy-lmw/hive-core';
+import type { ServerConfig } from './config.js';
+export interface HiveContext {
+    /** Message bus for event-driven communication */
+    bus: MessageBus;
+    /** Main agent instance */
+    agent: Agent;
+    /** Server configuration */
+    config: ServerConfig;
+    /** Loaded plugins */
+    plugins: IPlugin[];
+    /** Logger instance */
+    logger: ILogger;
+    /** Heartbeat scheduler (null — managed by server internally) */
+    heartbeatScheduler: null;
+    /** Schedule engine (null — managed by server internally) */
+    scheduleEngine: null;
+    /** Server instance (for stop/shutdown) */
+    server: Server;
+}
+export interface BootstrapOptions {
+    config: ServerConfig;
+}
+export declare function bootstrap(options: BootstrapOptions): Promise<HiveContext>;
+export declare function shutdown(ctx: HiveContext): Promise<void>;
+/**
+ * Normalize feishu plugin config: ensure `groups` field exists and is a plain object.
+ */
+export declare function normalizeFeishuPluginConfig(pluginConfig: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAEL,KAAK,KAAK,EACV,KAAK,OAAO,EACZ,KAAK,OAAO,EACZ,KAAK,MAAM,EACX,KAAK,UAAU,EAEhB,MAAM,sBAAsB,CAAA;AAE7B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAI/C,MAAM,WAAW,WAAW;IAC1B,iDAAiD;IACjD,GAAG,EAAE,UAAU,CAAA;IACf,0BAA0B;IAC1B,KAAK,EAAE,KAAK,CAAA;IACZ,2BAA2B;IAC3B,MAAM,EAAE,YAAY,CAAA;IACpB,qBAAqB;IACrB,OAAO,EAAE,OAAO,EAAE,CAAA;IAClB,sBAAsB;IACtB,MAAM,EAAE,OAAO,CAAA;IACf,gEAAgE;IAChE,kBAAkB,EAAE,IAAI,CAAA;IACxB,4DAA4D;IAC5D,cAAc,EAAE,IAAI,CAAA;IACpB,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,YAAY,CAAA;CACrB;AAcD,wBAAsB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC,CAqC/E;AAMD,wBAAsB,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAI9D;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoB1G"}

package/dist/bootstrap.js

@@ -0,0 +1,86 @@
+/**
+ * Hive Server Bootstrap
+ *
+ * Thin wrapper around createServer() that reads ServerConfig and
+ * returns a HiveContext compatible with the existing API surface.
+ */
+import { createServer, } from '@bundy-lmw/hive-core';
+import { join } from 'path';
+import { loadPlugins } from './plugins.js';
+import { HIVE_HOME } from './config.js';
+function createLogger(level) {
+    const levels = { debug: 0, info: 1, warn: 2, error: 3 };
+    const currentLevel = levels[level] ?? 1;
+    return {
+        debug: (msg, ...args) => currentLevel <= 0 && console.log(`[DEBUG] ${msg}`, ...args),
+        info: (msg, ...args) => currentLevel <= 1 && console.log(`[INFO] ${msg}`, ...args),
+        warn: (msg, ...args) => currentLevel <= 2 && console.warn(`[WARN] ${msg}`, ...args),
+        error: (msg, ...args) => currentLevel <= 3 && console.error(`[ERROR] ${msg}`, ...args),
+    };
+}
+export async function bootstrap(options) {
+    const { config } = options;
+    const logger = createLogger(config.logLevel);
+    const plugins = await loadPlugins();
+    const server = createServer({
+        config: {
+            externalConfig: {
+                providers: [
+                    {
+                        id: config.provider.id,
+                        name: config.provider.id.toUpperCase(),
+                        apiKey: config.provider.apiKey,
+                        model: config.provider.model,
+                    },
+                ],
+                activeProvider: config.provider.id,
+            },
+            heartbeat: config.heartbeat.enabled ? config.heartbeat : undefined,
+        },
+        plugins,
+        dbPath: join(HIVE_HOME, 'hive.db'),
+        logger,
+    });
+    await server.start();
+    return {
+        bus: server.bus,
+        agent: server.agent,
+        config,
+        plugins,
+        logger,
+        heartbeatScheduler: null,
+        scheduleEngine: null,
+        server,
+    };
+}
+// ============================================
+// Shutdown
+// ============================================
+export async function shutdown(ctx) {
+    ctx.logger.info('[shutdown] Starting graceful shutdown...');
+    await ctx.server.stop();
+    ctx.logger.info('[shutdown] Shutdown complete');
+}
+/**
+ * Normalize feishu plugin config: ensure `groups` field exists and is a plain object.
+ */
+export function normalizeFeishuPluginConfig(pluginConfig) {
+    const channels = pluginConfig.channels;
+    if (!channels || typeof channels !== 'object')
+        return pluginConfig;
+    const feishu = channels.feishu;
+    if (!feishu || typeof feishu !== 'object')
+        return pluginConfig;
+    const feishuConfig = feishu;
+    if ('groups' in feishuConfig && feishuConfig.groups !== null && typeof feishuConfig.groups === 'object' && !Array.isArray(feishuConfig.groups)) {
+        return pluginConfig;
+    }
+    return {
+        ...pluginConfig,
+        channels: {
+            ...channels,
+            feishu: { ...feishuConfig, groups: {} },
+        },
+    };
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist/bootstrap.js.map

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

package/dist/cli/index.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * Hive CLI Entry
+ *
+ * Command-line interface for Hive server.
+ */
+export declare function main(): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAEA;;;;GAIG;AA0IH,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAE1C"}

package/dist/cli/index.js

@@ -0,0 +1,125 @@
+#!/usr/bin/env node
+/**
+ * Hive CLI Entry
+ *
+ * Command-line interface for Hive server.
+ */
+import { Command } from 'commander';
+import { createPluginCommand } from '../plugin-manager/cli.js';
+const VERSION = '1.0.0';
+const program = new Command()
+    .name('hive')
+    .description('Hive - Multi-Agent Collaboration Framework')
+    .version(VERSION);
+// hive chat
+program
+    .command('chat')
+    .description('Start interactive chat mode')
+    .action(async () => {
+    const { createInterface } = await import('readline');
+    const rl = createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    console.log('Hive Chat - Type /exit to quit\n');
+    const { bootstrap } = await import('../bootstrap.js');
+    const { getConfig } = await import('../config.js');
+    const cfg = getConfig();
+    const ctx = await bootstrap({ config: { ...cfg, plugins: [] } });
+    const prompt = () => {
+        rl.question('You: ', async (input) => {
+            const trimmed = input.trim();
+            if (trimmed === '/exit' || trimmed === '/quit') {
+                console.log('Goodbye!');
+                rl.close();
+                process.exit(0);
+            }
+            if (!trimmed) {
+                prompt();
+                return;
+            }
+            try {
+                const response = await ctx.agent.chat(trimmed);
+                console.log(`\nAgent: ${response}\n`);
+            }
+            catch (error) {
+                console.error('Error:', error instanceof Error ? error.message : 'Unknown error');
+            }
+            prompt();
+        });
+    };
+    prompt();
+});
+// hive server
+program
+    .command('server')
+    .description('Start HTTP/WebSocket server')
+    .option('-p, --port <port>', 'Server port', undefined)
+    .action(async (options) => {
+    const { getConfig } = await import('../config.js');
+    const cfg = getConfig();
+    const serverPort = options.port ? parseInt(options.port, 10) : cfg.port;
+    console.log(`Starting Hive server on port ${serverPort}...`);
+    const serverConfig = { ...cfg, port: serverPort };
+    const { bootstrap } = await import('../bootstrap.js');
+    const ctx = await bootstrap({ config: serverConfig });
+    const { createServer } = await import('http');
+    const { createHttpGateway } = await import('../gateway/http.js');
+    const app = createHttpGateway(ctx);
+    const server = createServer();
+    const { createWebSocketGateway } = await import('../gateway/websocket.js');
+    createWebSocketGateway(server, ctx);
+    server.on('request', async (req, res) => {
+        try {
+            const url = `http://${req.headers.host || 'localhost'}${req.url}`;
+            const headers = new Headers();
+            for (const [key, value] of Object.entries(req.headers)) {
+                if (value) {
+                    headers.set(key, Array.isArray(value) ? value.join(', ') : value);
+                }
+            }
+            let body;
+            if (req.method !== 'GET' && req.method !== 'HEAD') {
+                const chunks = [];
+                for await (const chunk of req) {
+                    chunks.push(chunk);
+                }
+                body = Buffer.concat(chunks).toString();
+            }
+            const request = new Request(url, {
+                method: req.method,
+                headers,
+                body,
+            });
+            const response = await app.fetch(request);
+            res.statusCode = response.status;
+            response.headers.forEach((value, key) => {
+                res.setHeader(key, value);
+            });
+            const buffer = await response.arrayBuffer();
+            res.end(Buffer.from(buffer));
+        }
+        catch (err) {
+            console.error('[server] Request error:', err);
+            res.statusCode = 500;
+            res.end('Internal Server Error');
+        }
+    });
+    server.listen(serverPort, () => {
+        console.log(`\n✓ Hive server running at http://localhost:${serverPort}`);
+        console.log(`  - HTTP API: http://localhost:${serverPort}/api`);
+        console.log(`  - WebSocket: ws://localhost:${serverPort}/ws`);
+        console.log(`  - Health: http://localhost:${serverPort}/health`);
+        console.log();
+    });
+});
+// hive plugin
+program.addCommand(createPluginCommand());
+export async function main() {
+    program.parse();
+}
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Hive Server Configuration
+ *
+ * Loads configuration from hive.config.json with environment variable interpolation.
+ * Falls back to .env for backwards compatibility.
+ */
+export declare const HIVE_HOME: string;
+/**
+ * Raw JSON configuration structure
+ */
+export interface HeartbeatConfigJson {
+    enabled?: boolean;
+    intervalMs?: number;
+    model?: string;
+    prompt?: string;
+}
+export interface HiveConfigJson {
+    server?: {
+        port?: number;
+        host?: string;
+        logLevel?: 'debug' | 'info' | 'warn' | 'error';
+    };
+    auth?: {
+        enabled?: boolean;
+        apiKey?: string;
+    };
+    provider?: {
+        id: string;
+        apiKey?: string;
+        model?: string;
+        baseUrl?: string;
+    };
+    heartbeat?: HeartbeatConfigJson;
+    plugins?: Record<string, Record<string, unknown>>;
+}
+/**
+ * Resolved server configuration
+ */
+export interface HeartbeatConfig {
+    enabled: boolean;
+    intervalMs: number;
+    model?: string;
+    prompt?: string;
+}
+export interface ServerConfig {
+    /** HTTP server port */
+    port: number;
+    /** Host to bind to */
+    host: string;
+    /** Log level: debug, info, warn, error */
+    logLevel: 'debug' | 'info' | 'warn' | 'error';
+    /** Plugin packages to load */
+    plugins: string[];
+    /** Authentication configuration */
+    auth: {
+        /** Whether API key authentication is enabled */
+        enabled: boolean;
+        /** API key for authentication */
+        apiKey: string;
+    };
+    /** LLM provider configuration */
+    provider: {
+        /** Provider ID (e.g., glm, anthropic, openai) */
+        id: string;
+        /** API key */
+        apiKey: string;
+        /** Model to use */
+        model?: string;
+        /** API base URL */
+        baseUrl?: string;
+    };
+    /** Heartbeat schedule configuration */
+    heartbeat: HeartbeatConfig;
+    /** Plugin configurations (key = plugin name, value = config to pass) */
+    pluginConfigs: Record<string, Record<string, unknown>>;
+}
+/**
+ * Load configuration from hive.config.json with fallbacks
+ */
+export declare function loadConfig(): ServerConfig;
+/**
+ * Get configuration for a specific plugin
+ */
+export declare function getPluginConfig(config: ServerConfig, pluginName: string): Record<string, unknown>;
+/**
+ * Get configuration (lazy-loaded singleton)
+ */
+export declare function getConfig(): ServerConfig;
+/**
+ * Reset cached config (for testing)
+ */
+export declare function resetConfig(): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoBH,eAAO,MAAM,SAAS,QAAgB,CAAA;AAYtC;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE;QACP,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;KAC/C,CAAA;IACD,IAAI,CAAC,EAAE;QACL,OAAO,CAAC,EAAE,OAAO,CAAA;QACjB,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,CAAA;IACD,QAAQ,CAAC,EAAE;QACT,EAAE,EAAE,MAAM,CAAA;QACV,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,OAAO,CAAC,EAAE,MAAM,CAAA;KACjB,CAAA;IACD,SAAS,CAAC,EAAE,mBAAmB,CAAA;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CAClD;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,0CAA0C;IAC1C,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;IAC7C,8BAA8B;IAC9B,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,mCAAmC;IACnC,IAAI,EAAE;QACJ,gDAAgD;QAChD,OAAO,EAAE,OAAO,CAAA;QAChB,iCAAiC;QACjC,MAAM,EAAE,MAAM,CAAA;KACf,CAAA;IACD,iCAAiC;IACjC,QAAQ,EAAE;QACR,iDAAiD;QACjD,EAAE,EAAE,MAAM,CAAA;QACV,cAAc;QACd,MAAM,EAAE,MAAM,CAAA;QACd,mBAAmB;QACnB,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,mBAAmB;QACnB,OAAO,CAAC,EAAE,MAAM,CAAA;KACjB,CAAA;IACD,uCAAuC;IACvC,SAAS,EAAE,eAAe,CAAA;IAC1B,wEAAwE;IACxE,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CACvD;AAuED;;GAEG;AACH,wBAAgB,UAAU,IAAI,YAAY,CAyCzC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEjG;AAKD;;GAEG;AACH,wBAAgB,SAAS,IAAI,YAAY,CAKxC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAElC"}