axon-code 2.4.0

package/dist/network/discovery.js

@@ -0,0 +1,398 @@
+/**
+ * 局域网 Agent 发现
+ *
+ * 双重发现机制：
+ *   1. 文件注册（本地）— 每个实例写 ~/.axon/network/peers/{port}.json，定期扫描
+ *      可靠、跨平台、同机器多实例零问题
+ *   2. mDNS/DNS-SD（局域网）— 基于 bonjour-service，跨机器发现
+ *      Windows 同机器多进程不可靠，仅作补充
+ */
+import { EventEmitter } from 'events';
+import * as crypto from 'crypto';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { computeFingerprint } from './identity.js';
+// 服务类型常量
+const SERVICE_TYPE = 'axon-agent';
+const SERVICE_PROTOCOL = 'tcp';
+// 本地注册目录
+const PEERS_DIR = path.join(os.homedir(), '.axon', 'network', 'peers');
+export class AgentDiscovery extends EventEmitter {
+    bonjour = null;
+    service = null;
+    browser = null;
+    agents = new Map();
+    healthCheckTimer = null;
+    peerScanTimer = null;
+    peerFile = null;
+    selfAgentId = '';
+    peersDir;
+    /** Agent 离线超时（90 秒未见心跳） */
+    OFFLINE_TIMEOUT = 90_000;
+    /** 健康检查间隔（30 秒） */
+    HEALTH_CHECK_INTERVAL = 30_000;
+    /** 本地 peer 扫描间隔（5 秒） */
+    PEER_SCAN_INTERVAL = 5_000;
+    constructor(options) {
+        super();
+        this.peersDir = options?.peersDir ?? PEERS_DIR;
+    }
+    /**
+     * 获取所有发现的 Agent
+     */
+    getDiscoveredAgents() {
+        return Array.from(this.agents.values());
+    }
+    /**
+     * 获取指定 Agent
+     */
+    getAgent(agentId) {
+        return this.agents.get(agentId);
+    }
+    /**
+     * 启动发现服务
+     */
+    async start(identity, port, advertise) {
+        this.selfAgentId = identity.agentId;
+        // ====== 1. 文件注册（主要发现机制，同机器可靠） ======
+        if (advertise) {
+            this.registerPeerFile(identity, port);
+        }
+        // 启动 peer 扫描
+        this.scanPeers(identity);
+        this.peerScanTimer = setInterval(() => {
+            this.scanPeers(identity);
+        }, this.PEER_SCAN_INTERVAL);
+        // ====== 2. mDNS（补充发现机制，跨机器） ======
+        try {
+            const { Bonjour } = await import('bonjour-service');
+            this.bonjour = new Bonjour();
+        }
+        catch (err) {
+            console.warn('[AgentDiscovery] bonjour-service not available, mDNS disabled (file-based local discovery still active)');
+            // mDNS 不可用不影响本地发现
+            this.startHealthCheck();
+            return;
+        }
+        // 广播自己
+        if (advertise) {
+            try {
+                this.service = this.bonjour.publish({
+                    name: `axon-${identity.agentId.slice(0, 8)}-${port}`,
+                    type: SERVICE_TYPE,
+                    protocol: SERVICE_PROTOCOL,
+                    port,
+                    txt: {
+                        agentId: identity.agentId,
+                        ownerFp: this.computeOwnerFp(identity),
+                        projects: identity.projects.map(p => p.name).join(','),
+                        version: identity.version,
+                        name: identity.name,
+                    },
+                });
+            }
+            catch (err) {
+                console.warn('[AgentDiscovery] mDNS publish failed (file-based discovery still active):', err instanceof Error ? err.message : err);
+            }
+        }
+        // 浏览局域网
+        try {
+            this.browser = this.bonjour.find({
+                type: SERVICE_TYPE,
+                protocol: SERVICE_PROTOCOL,
+            });
+            this.browser.on('up', (service) => {
+                this.handleServiceFound(service, identity);
+            });
+            this.browser.on('down', (service) => {
+                const agentId = service.txt?.agentId;
+                if (agentId && this.agents.has(agentId)) {
+                    this.agents.delete(agentId);
+                    this.emit('lost', agentId);
+                }
+            });
+        }
+        catch (err) {
+            console.warn('[AgentDiscovery] mDNS browse failed:', err instanceof Error ? err.message : err);
+        }
+        // 启动健康检查
+        this.startHealthCheck();
+    }
+    // ===== 文件注册发现 =====
+    /**
+     * 写注册文件到 ~/.axon/network/peers/{port}.json
+     */
+    registerPeerFile(identity, port) {
+        try {
+            if (!fs.existsSync(this.peersDir)) {
+                fs.mkdirSync(this.peersDir, { recursive: true });
+            }
+            const registration = {
+                agentId: identity.agentId,
+                name: identity.name,
+                port,
+                ownerFp: this.computeOwnerFp(identity),
+                projects: identity.projects.map(p => p.name),
+                version: identity.version,
+                pid: process.pid,
+                startedAt: Date.now(),
+            };
+            this.peerFile = path.join(this.peersDir, `${port}.json`);
+            fs.writeFileSync(this.peerFile, JSON.stringify(registration, null, 2));
+            // 进程退出时清理
+            const cleanup = () => {
+                try {
+                    if (this.peerFile && fs.existsSync(this.peerFile)) {
+                        fs.unlinkSync(this.peerFile);
+                    }
+                }
+                catch {
+                    // ignore
+                }
+            };
+            process.on('exit', cleanup);
+            process.on('SIGINT', () => { cleanup(); process.exit(0); });
+            process.on('SIGTERM', () => { cleanup(); process.exit(0); });
+        }
+        catch (err) {
+            console.warn('[AgentDiscovery] Failed to register peer file:', err instanceof Error ? err.message : err);
+        }
+    }
+    /**
+     * 扫描 peers 目录发现本地实例
+     */
+    scanPeers(selfIdentity) {
+        try {
+            if (!fs.existsSync(this.peersDir))
+                return;
+            const files = fs.readdirSync(this.peersDir).filter(f => f.endsWith('.json'));
+            const seenIds = new Set();
+            for (const file of files) {
+                try {
+                    const filePath = path.join(this.peersDir, file);
+                    const content = fs.readFileSync(filePath, 'utf-8');
+                    const reg = JSON.parse(content);
+                    // 跳过自己
+                    if (reg.agentId === selfIdentity.agentId)
+                        continue;
+                    // 检查进程是否还活着
+                    if (!this.isProcessAlive(reg.pid)) {
+                        // 进程已死，清理注册文件
+                        try {
+                            fs.unlinkSync(filePath);
+                        }
+                        catch { /* ignore */ }
+                        // 如果之前发现过，标记为 lost
+                        if (this.agents.has(reg.agentId)) {
+                            this.agents.delete(reg.agentId);
+                            this.emit('lost', reg.agentId);
+                        }
+                        continue;
+                    }
+                    seenIds.add(reg.agentId);
+                    const endpoint = `127.0.0.1:${reg.port}`;
+                    const now = Date.now();
+                    const existing = this.agents.get(reg.agentId);
+                    if (existing) {
+                        existing.lastSeenAt = now;
+                        existing.online = true;
+                        existing.endpoint = endpoint;
+                        this.emit('updated', existing);
+                    }
+                    else {
+                        const agent = {
+                            agentId: reg.agentId,
+                            name: reg.name,
+                            ownerFingerprint: reg.ownerFp,
+                            projects: reg.projects,
+                            endpoint,
+                            discoveredAt: now,
+                            lastSeenAt: now,
+                            trustLevel: 'unknown',
+                            online: true,
+                        };
+                        this.agents.set(reg.agentId, agent);
+                        this.emit('found', agent);
+                    }
+                }
+                catch {
+                    // 单文件解析失败不影响其他
+                }
+            }
+        }
+        catch {
+            // 目录不可读不影响 mDNS 发现
+        }
+    }
+    /**
+     * 检查 PID 对应的进程是否存活
+     */
+    isProcessAlive(pid) {
+        try {
+            // kill(pid, 0) 不发送信号，仅检查进程是否存在
+            process.kill(pid, 0);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    // ===== mDNS 发现 =====
+    /**
+     * 处理 mDNS 发现的服务
+     */
+    handleServiceFound(service, selfIdentity) {
+        const txt = service.txt || {};
+        const agentId = txt.agentId;
+        if (!agentId || agentId === selfIdentity.agentId)
+            return; // 跳过自己
+        // 优先选择 IPv4 地址（IPv6 link-local 在 Windows 上跨机器不可靠）
+        const ipv4 = service.addresses?.find(a => /^\d+\.\d+\.\d+\.\d+$/.test(a));
+        const address = ipv4 || service.addresses?.[0] || service.host;
+        // IPv6 地址需要方括号包裹，否则 ws://addr:port 格式无法解析
+        const host = address.includes(':') ? `[${address}]` : address;
+        const endpoint = `${host}:${service.port}`;
+        const ownerFingerprint = txt.ownerFp || '';
+        const existing = this.agents.get(agentId);
+        const now = Date.now();
+        if (existing) {
+            // 更新最后心跳
+            existing.lastSeenAt = now;
+            existing.online = true;
+            existing.endpoint = endpoint;
+            this.emit('updated', existing);
+        }
+        else {
+            // 新 Agent
+            const agent = {
+                agentId,
+                name: txt.name || agentId.slice(0, 8),
+                ownerFingerprint,
+                projects: (txt.projects || '').split(',').filter(Boolean),
+                endpoint,
+                discoveredAt: now,
+                lastSeenAt: now,
+                trustLevel: 'unknown', // 握手后更新
+                online: true,
+            };
+            this.agents.set(agentId, agent);
+            this.emit('found', agent);
+        }
+    }
+    // ===== 健康检查 =====
+    startHealthCheck() {
+        this.healthCheckTimer = setInterval(() => {
+            this.checkHealth();
+        }, this.HEALTH_CHECK_INTERVAL);
+    }
+    /**
+     * 健康检查：标记超时 Agent 为离线
+     */
+    checkHealth() {
+        const now = Date.now();
+        for (const [agentId, agent] of this.agents) {
+            if (agent.online && now - agent.lastSeenAt > this.OFFLINE_TIMEOUT) {
+                agent.online = false;
+                this.emit('updated', agent);
+            }
+        }
+    }
+    /**
+     * 手动添加 Agent（用于防火墙环境下无法 mDNS 发现时）
+     */
+    addManual(endpoint, agentId, name) {
+        const agent = {
+            agentId,
+            name,
+            ownerFingerprint: '',
+            projects: [],
+            endpoint,
+            discoveredAt: Date.now(),
+            lastSeenAt: Date.now(),
+            trustLevel: 'unknown',
+            online: true,
+        };
+        this.agents.set(agentId, agent);
+        this.emit('found', agent);
+        return agent;
+    }
+    /**
+     * 更新 Agent 信息（握手后用完整身份更新）
+     */
+    updateAgent(agentId, updates) {
+        const agent = this.agents.get(agentId);
+        if (agent) {
+            Object.assign(agent, updates);
+            this.emit('updated', agent);
+        }
+    }
+    /**
+     * 移除 Agent
+     */
+    removeAgent(agentId) {
+        if (this.agents.delete(agentId)) {
+            this.emit('lost', agentId);
+        }
+    }
+    /**
+     * 从 AgentIdentity 计算 owner 指纹
+     * owner.publicKey 是 base64(DER) 格式，需要先重建 PEM 再计算 fingerprint
+     */
+    computeOwnerFp(identity) {
+        try {
+            const ownerKeyObj = crypto.createPublicKey({
+                key: Buffer.from(identity.owner.publicKey, 'base64'),
+                format: 'der',
+                type: 'spki',
+            });
+            const ownerPem = ownerKeyObj.export({ type: 'spki', format: 'pem' });
+            return computeFingerprint(ownerPem);
+        }
+        catch {
+            return '';
+        }
+    }
+    /**
+     * 停止发现服务
+     */
+    async stop() {
+        // 清理 peer 扫描
+        if (this.peerScanTimer) {
+            clearInterval(this.peerScanTimer);
+            this.peerScanTimer = null;
+        }
+        // 清理注册文件
+        if (this.peerFile) {
+            try {
+                if (fs.existsSync(this.peerFile)) {
+                    fs.unlinkSync(this.peerFile);
+                }
+            }
+            catch {
+                // ignore
+            }
+            this.peerFile = null;
+        }
+        // 清理健康检查
+        if (this.healthCheckTimer) {
+            clearInterval(this.healthCheckTimer);
+            this.healthCheckTimer = null;
+        }
+        // 清理 mDNS
+        if (this.browser) {
+            this.browser.stop();
+            this.browser = null;
+        }
+        if (this.service) {
+            this.service.stop();
+            this.service = null;
+        }
+        if (this.bonjour) {
+            this.bonjour.destroy();
+            this.bonjour = null;
+        }
+        this.agents.clear();
+    }
+}
+//# sourceMappingURL=discovery.js.map

package/dist/network/discovery.js.map

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

package/dist/network/global-proxy.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 全局代理设置
+ *
+ * 让 Node.js 内置 fetch（基于 undici）自动走代理。
+ * 在进程启动极早期 import 一次即可，所有后续的 fetch() 调用（包括第三方 SDK 如 @google/genai）
+ * 都会自动经过代理，无需逐个客户端单独配置。
+ *
+ * 代理来源优先级:
+ *   1. 环境变量 HTTP_PROXY / HTTPS_PROXY
+ *   2. settings.json 中的 proxy.http / proxy.https
+ *
+ * 依赖: undici（Node.js 内置）
+ */
+/**
+ * 初始化全局 fetch 代理
+ * 幂等，多次调用安全
+ */
+export declare function setupGlobalFetchProxy(): void;
+//# sourceMappingURL=global-proxy.d.ts.map

package/dist/network/global-proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-proxy.d.ts","sourceRoot":"","sources":["../../src/network/global-proxy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AA6BH;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAoC5C"}

package/dist/network/global-proxy.js

@@ -0,0 +1,81 @@
+/**
+ * 全局代理设置
+ *
+ * 让 Node.js 内置 fetch（基于 undici）自动走代理。
+ * 在进程启动极早期 import 一次即可，所有后续的 fetch() 调用（包括第三方 SDK 如 @google/genai）
+ * 都会自动经过代理，无需逐个客户端单独配置。
+ *
+ * 代理来源优先级:
+ *   1. 环境变量 HTTP_PROXY / HTTPS_PROXY
+ *   2. settings.json 中的 proxy.http / proxy.https
+ *
+ * 依赖: undici（Node.js 内置）
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { createRequire } from 'module';
+let initialized = false;
+/**
+ * 从 settings.json 读取代理配置（轻量级，不依赖 configManager 避免循环依赖）
+ */
+function getProxyFromSettings() {
+    try {
+        const settingsPath = path.join(os.homedir(), '.axon', 'settings.json');
+        if (!fs.existsSync(settingsPath))
+            return {};
+        const settings = JSON.parse(fs.readFileSync(settingsPath, 'utf-8'));
+        if (settings.proxy) {
+            return {
+                http: settings.proxy.http,
+                https: settings.proxy.https,
+            };
+        }
+    }
+    catch {
+        // settings 读取失败不影响启动
+    }
+    return {};
+}
+/**
+ * 初始化全局 fetch 代理
+ * 幂等，多次调用安全
+ */
+export function setupGlobalFetchProxy() {
+    if (initialized)
+        return;
+    initialized = true;
+    // 优先环境变量，其次 settings.json
+    let proxyUrl = process.env.HTTPS_PROXY || process.env.https_proxy
+        || process.env.HTTP_PROXY || process.env.http_proxy;
+    if (!proxyUrl) {
+        const settingsProxy = getProxyFromSettings();
+        proxyUrl = settingsProxy.https || settingsProxy.http;
+        if (proxyUrl) {
+            // 写入环境变量，让 EnvHttpProxyAgent 能读到
+            if (settingsProxy.https)
+                process.env.HTTPS_PROXY = settingsProxy.https;
+            if (settingsProxy.http)
+                process.env.HTTP_PROXY = settingsProxy.http;
+        }
+    }
+    if (!proxyUrl)
+        return;
+    try {
+        // undici 是 Node.js 内置 fetch 的底层实现
+        // EnvHttpProxyAgent 自动读取 HTTP_PROXY/HTTPS_PROXY/NO_PROXY
+        // 使用 createRequire 确保在 ESM/tsx 环境下也能正确加载
+        const nodeRequire = createRequire(import.meta.url);
+        const undici = nodeRequire('undici');
+        const { EnvHttpProxyAgent, setGlobalDispatcher } = undici;
+        if (EnvHttpProxyAgent && setGlobalDispatcher) {
+            setGlobalDispatcher(new EnvHttpProxyAgent());
+            console.log(`[GlobalProxy] fetch proxy enabled: ${proxyUrl}`);
+        }
+    }
+    catch (err) {
+        // undici 不可用时静默降级，不影响启动
+        console.warn('[GlobalProxy] Failed to setup fetch proxy:', err.message);
+    }
+}
+//# sourceMappingURL=global-proxy.js.map

package/dist/network/global-proxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-proxy.js","sourceRoot":"","sources":["../../src/network/global-proxy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAEvC,IAAI,WAAW,GAAG,KAAK,CAAC;AAExB;;GAEG;AACH,SAAS,oBAAoB;IAC3B,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC;QACvE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC;YAAE,OAAO,EAAE,CAAC;QAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;QACpE,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YACnB,OAAO;gBACL,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI;gBACzB,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,KAAK;aAC5B,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,qBAAqB;IACvB,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB;IACnC,IAAI,WAAW;QAAE,OAAO;IACxB,WAAW,GAAG,IAAI,CAAC;IAEnB,0BAA0B;IAC1B,IAAI,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW;WAC5D,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;IAEtD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,aAAa,GAAG,oBAAoB,EAAE,CAAC;QAC7C,QAAQ,GAAG,aAAa,CAAC,KAAK,IAAI,aAAa,CAAC,IAAI,CAAC;QACrD,IAAI,QAAQ,EAAE,CAAC;YACb,iCAAiC;YACjC,IAAI,aAAa,CAAC,KAAK;gBAAE,OAAO,CAAC,GAAG,CAAC,WAAW,GAAG,aAAa,CAAC,KAAK,CAAC;YACvE,IAAI,aAAa,CAAC,IAAI;gBAAE,OAAO,CAAC,GAAG,CAAC,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC;QACtE,CAAC;IACH,CAAC;IAED,IAAI,CAAC,QAAQ;QAAE,OAAO;IAEtB,IAAI,CAAC;QACH,kCAAkC;QAClC,yDAAyD;QACzD,yCAAyC;QACzC,MAAM,WAAW,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;QACrC,MAAM,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,GAAG,MAAM,CAAC;QAE1D,IAAI,iBAAiB,IAAI,mBAAmB,EAAE,CAAC;YAC7C,mBAAmB,CAAC,IAAI,iBAAiB,EAAE,CAAC,CAAC;YAC7C,OAAO,CAAC,GAAG,CAAC,sCAAsC,QAAQ,EAAE,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,wBAAwB;QACxB,OAAO,CAAC,IAAI,CAAC,4CAA4C,EAAG,GAAa,CAAC,OAAO,CAAC,CAAC;IACrF,CAAC;AACH,CAAC"}

package/dist/network/identity.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Agent 身份系统
+ *
+ * 基于 Ed25519 的密钥管理、Agent 身份卡片、Owner 归属证书。
+ *
+ * 密钥存储:
+ *   ~/.axon/network/
+ *     ├── owner.key      # Owner 私钥 (PEM)
+ *     ├── owner.pub      # Owner 公钥 (PEM)
+ *     ├── agent.key      # Agent 私钥 (PEM)
+ *     ├── agent.pub      # Agent 公钥 (PEM)
+ *     └── agent-cert.sig # Owner 对 Agent 的归属证书
+ */
+import type { AgentIdentity, NetworkConfig } from './types.js';
+/**
+ * 计算公钥的 agentId：SHA-256 哈希前 16 字节 (hex)
+ */
+export declare function computeAgentId(publicKeyPem: string): string;
+/**
+ * 计算公钥指纹：SHA-256 前 8 字节 (hex)
+ */
+export declare function computeFingerprint(publicKeyPem: string): string;
+/**
+ * 用私钥签名数据
+ */
+export declare function sign(data: Buffer | string, privateKeyPem: string): string;
+/**
+ * 用公钥验签
+ */
+export declare function verify(data: Buffer | string, signature: string, publicKeyPem: string): boolean;
+export declare class IdentityManager {
+    private keys;
+    private _identity;
+    get identity(): AgentIdentity;
+    get agentId(): string;
+    get agentPrivateKey(): string;
+    get ownerFingerprint(): string;
+    /**
+     * 初始化身份系统
+     * @param config 网络配置
+     * @param cwd 工作目录
+     * @param actualPort 实际绑定的端口号（用于区分同机器多实例的身份）
+     */
+    initialize(config: NetworkConfig, cwd: string, actualPort?: number): Promise<void>;
+    /**
+     * 验证远程 Agent 的归属证书
+     */
+    verifyCertificate(remoteIdentity: AgentIdentity): boolean;
+    /**
+     * 判断远程 Agent 是否同 Owner
+     */
+    isSameOwner(remoteIdentity: AgentIdentity): boolean;
+    /**
+     * 从工作目录推断能力
+     */
+    private inferCapabilities;
+}
+//# sourceMappingURL=identity.d.ts.map

package/dist/network/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/network/identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,OAAO,KAAK,EAAE,aAAa,EAAe,aAAa,EAAE,MAAM,YAAY,CAAC;AAmC5E;;GAEG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAI3D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAI/D;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAGzE;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAM9F;AA0FD,qBAAa,eAAe;IAC1B,OAAO,CAAC,IAAI,CAAc;IAC1B,OAAO,CAAC,SAAS,CAAiB;IAElC,IAAI,QAAQ,IAAI,aAAa,CAE5B;IAED,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,IAAI,eAAe,IAAI,MAAM,CAE5B;IAED,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IAED;;;;;OAKG;IACG,UAAU,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqCxF;;OAEG;IACH,iBAAiB,CAAC,cAAc,EAAE,aAAa,GAAG,OAAO;IAiBzD;;OAEG;IACH,WAAW,CAAC,cAAc,EAAE,aAAa,GAAG,OAAO;IAInD;;OAEG;IACH,OAAO,CAAC,iBAAiB;CA6B1B"}