@wings006/agent-link 0.1.0

package/README.md

@@ -0,0 +1,298 @@
+# Agent Link
+
+多 Agent 聊天系统 — 连接多台电脑上的 Claude Code，实现 Agent 间互相通信。支持局域网自动发现和跨网络中继通信。
+
+## 工作原理
+
+每台电脑运行一个 `agent-link` 进程，同时承担：
+
+- **MCP Server** — 给本地 Claude Code 提供 `agent_list`、`agent_send`、`agent_inbox`、`agent_reply` 工具
+- **A2A Server** — 接收其他电脑 Agent 发来的任务（HTTP JSON-RPC）
+- **A2A Client** — 向其他电脑的 Agent 发送任务
+- **mDNS 广播** — 零配置自动发现局域网内所有 Agent
+
+```
+电脑A (wings-macbook)          电脑B (office-pc)          电脑C (lab-server)
+┌───────────────┐            ┌───────────────┐          ┌───────────────┐
+│  agent-link   │◄──HTTP───►│  agent-link   │◄──HTTP──►│  agent-link   │
+│  + Claude Code│   (A2A)   │  + Claude Code│  (A2A)   │  + Claude Code│
+└───────────────┘           └───────────────┘          └───────────────┘
+        ▲ mDNS 自动发现 ▲                    ▲ mDNS 自动发现 ▲
+```
+
+## 安装
+
+```bash
+git clone <repo-url> agent-link
+cd agent-link
+npm install
+npm run build
+npm link
+```
+
+执行 `npm link` 后，`agent-link` 命令全局可用。
+
+## 配置 Claude Code
+
+编辑 `~/.claude/settings.json`，添加 MCP Server：
+
+```json
+{
+  "mcpServers": {
+    "agent-link": {
+      "command": "agent-link",
+      "args": ["--name", "你的Agent名称", "--port", "3456"]
+    }
+  }
+}
+```
+
+每台电脑使用不同的 `--name`，同一局域网内 `--port` 保持一致即可。
+
+### 参数说明
+
+| 参数 | 简写 | 说明 | 默认值 |
+|------|------|------|--------|
+| `--name` | `-n` | Agent 名称（全局唯一） | 随机生成 |
+| `--port` | `-p` | A2A Server 监听端口 | 3456 |
+| `--relay` | `-r` | 中继服务器地址（跨网络通信） | 无 |
+| `--skills` | `-s` | 能力标签，逗号分隔 | general |
+
+### 配置示例
+
+**电脑 A（开发机）：**
+```json
+{
+  "mcpServers": {
+    "agent-link": {
+      "command": "agent-link",
+      "args": ["--name", "dev-macbook", "--port", "3456", "--skills", "code,test"]
+    }
+  }
+}
+```
+
+**电脑 B（办公电脑）：**
+```json
+{
+  "mcpServers": {
+    "agent-link": {
+      "command": "agent-link",
+      "args": ["--name", "office-pc", "--port", "3456", "--skills", "report,doc"]
+    }
+  }
+}
+```
+
+## 使用
+
+配置完成后重启 Claude Code，agent-link 会自动启动。直接用自然语言和 Claude Code 对话即可：
+
+### 查看在线 Agent
+
+```
+你: 有哪些 agent 在线？
+Claude Code → 调用 agent_list
+Claude Code: 当前在线 Agent:
+  - dev-macbook (192.168.1.50:3456) [code, test]
+  - office-pc (192.168.1.100:3456) [report, doc]
+```
+
+### 发送任务
+
+```
+你: 告诉 office-pc 帮我生成本周周报
+Claude Code → 调用 agent_send(to: "office-pc", message: "帮我生成本周周报")
+Claude Code: 任务已发送，等待 office-pc 处理...
+```
+
+对方电脑的 Claude Code 会收到消息，询问用户是否执行。
+
+### 查看收件箱
+
+```
+你: 看看有没有人给我发消息
+Claude Code → 调用 agent_inbox
+Claude Code: 收到 1 条消息:
+  - 来自 dev-macbook: "帮我检查一下测试覆盖率" (待处理)
+```
+
+### 回复任务
+
+```
+你: 回复这个任务，告诉他测试覆盖率是 85%
+Claude Code → 调用 agent_reply(task_id: "xxx", message: "测试覆盖率 85%", status: "completed")
+Claude Code: 已回复 dev-macbook
+```
+
+## 消息流转
+
+完整的一次跨机器任务流程：
+
+```
+1. A 用户 → A Claude Code: "告诉 office-pc 生成周报"
+2. A Claude Code 调用 agent_list 确认 office-pc 在线
+3. A Claude Code 调用 agent_send → A 的 agent-link 发送 HTTP 请求到 B
+4. B 的 agent-link 收到任务，存入 inbox
+5. B 的 Claude Code 通过 agent_inbox 看到新消息
+6. B 的 Claude Code 询问 B 用户: "收到 dev-macbook 的请求，是否执行？"
+7. B 用户确认 → B Claude Code 执行任务
+8. B Claude Code 调用 agent_reply 回复结果
+9. A Claude Code 收到结果，展示给 A 用户
+```
+
+## MCP 工具一览
+
+| 工具 | 说明 |
+|------|------|
+| `agent_list` | 列出所有在线 Agent（局域网 + 中继） |
+| `agent_send` | 向目标 Agent 发送消息/任务 |
+| `agent_inbox` | 查看收到的消息（显示已读/未读状态） |
+| `agent_reply` | 回复任务（完成/拒绝/需要更多信息） |
+| `agent_mark_read` | 标记消息已读（单条或全部） |
+| `agent_clear_inbox` | 清理收件箱（已读/全部/最早N条） |
+| `agent_task_status` | 查询已发出任务的状态和回复 |
+
+## 跨网络通信（中继模式）
+
+当 Agent 不在同一局域网时，可通过公网中继服务器实现通信。
+
+### 部署中继服务器
+
+在公网服务器上：
+
+```bash
+# 创建目录
+mkdir -p /opt/agent-link-relay && cd /opt/agent-link-relay
+
+# 复制中继服务器文件
+scp dist/relay-server.js user@server:/opt/agent-link-relay/
+
+# 安装依赖
+npm init -y
+sed -i 's/"type": "commonjs"/"type": "module"/' package.json
+npm install ws
+
+# 启动
+node relay-server.js --port 3458
+```
+
+建议用 systemd 管理：
+
+```ini
+# /etc/systemd/system/agent-link-relay.service
+[Unit]
+Description=Agent Link Relay Server
+After=network.target
+
+[Service]
+Type=simple
+WorkingDirectory=/opt/agent-link-relay
+ExecStart=/usr/bin/node relay-server.js --port 3458
+Restart=always
+RestartSec=5
+
+[Install]
+WantedBy=multi-user.target
+```
+
+```bash
+systemctl enable agent-link-relay && systemctl start agent-link-relay
+```
+
+> 注意：需要在云服务商安全组中放行 3458 端口（TCP 入方向）。
+
+### 配置 Agent 连接中继
+
+在 MCP 配置中添加 `--relay` 参数：
+
+```json
+{
+  "mcpServers": {
+    "agent-link": {
+      "command": "agent-link",
+      "args": ["--name", "my-agent", "--relay", "ws://your-server-ip:3458"]
+    }
+  }
+}
+```
+
+### 工作原理
+
+```
+电脑A (家里)                   公网中继服务器                    电脑B (公司)
+┌───────────┐    WebSocket    ┌──────────────┐    WebSocket    ┌───────────┐
+│ agent-link├──────────────►│ relay-server │◄──────────────┤agent-link │
+└───────────┘                 └──────────────┘                 └───────────┘
+```
+
+- 双方通过 WebSocket 长连接到中继服务器
+- 中继服务器维护在线 Agent 列表，推送给所有客户端
+- 消息通过中继转发，中继不存储数据
+- 局域网 mDNS 发现照常工作，同网络内优先直连
+
+## 本机测试
+
+在同一台机器上模拟多 Agent 通信（使用不同端口）：
+
+**终端 1：**
+```bash
+agent-link --name agent-a --port 3456
+```
+
+**终端 2：**
+```bash
+agent-link --name agent-b --port 3457
+```
+
+两个进程会通过 mDNS 自动发现对方。
+
+## 故障排查
+
+### mDNS 发现调试
+
+如果两台电脑都配置了 agent-link 但 `agent_list` 看不到对方，使用调试脚本排查：
+
+**电脑 A：**
+```bash
+npx tsx tests/mdns-debug.ts pc-a
+```
+
+**电脑 B：**
+```bash
+npx tsx tests/mdns-debug.ts pc-b
+```
+
+脚本会广播自身并监听局域网内的其他 Agent。如果 10 秒内双方都能看到 `[mDNS] 发现服务: ...` 输出，说明 mDNS 工作正常。
+
+如果发现不了对方，常见原因：
+
+| 原因 | 排查方法 |
+|------|---------|
+| macOS 防火墙阻止 UDP 5353 | 系统设置 → 网络 → 防火墙，关闭或添加例外 |
+| 两台电脑不在同一子网 | 确认 IP 在同一网段（如都是 192.168.1.x） |
+| 路由器禁用多播转发 | 检查路由器设置，启用 mDNS/Bonjour 转发 |
+| 企业网络隔离 | 部分企业 WiFi 会隔离客户端间通信 |
+
+## 开发
+
+```bash
+npm run build      # 编译 TypeScript
+npm run dev        # 开发模式运行（tsx）
+npm test           # 运行测试
+npm run test:watch # 测试监听模式
+```
+
+## 技术栈
+
+- TypeScript + Node.js
+- [A2A 协议](https://github.com/a2aproject/A2A) — Agent 间通信（JSON-RPC over HTTP）
+- [MCP 协议](https://modelcontextprotocol.io/) — Claude Code 工具集成
+- [bonjour-service](https://www.npmjs.com/package/bonjour-service) — mDNS 零配置局域网发现
+- [ws](https://www.npmjs.com/package/ws) — WebSocket 中继通信
+- [better-sqlite3](https://www.npmjs.com/package/better-sqlite3) — SQLite 持久化存储
+- [Vitest](https://vitest.dev/) — 测试框架
+
+## 许可证
+
+MIT

package/dist/a2a-client.d.ts

@@ -0,0 +1,12 @@
+import type { AgentInfo, Task } from "./types.js";
+export declare class A2AClient {
+    sendTask(target: AgentInfo, from: string, message: string, callbackUrl?: string): Promise<{
+        taskId: string;
+        status: string;
+    }>;
+    getTask(target: AgentInfo, taskId: string): Promise<Task>;
+    sendTaskNotification(callbackUrl: string, task: Task): Promise<void>;
+    waitForTask(target: AgentInfo, taskId: string, timeoutMs?: number, pollIntervalMs?: number): Promise<Task>;
+    getAgentCard(target: AgentInfo): Promise<Record<string, unknown>>;
+    private rpcCall;
+}

package/dist/a2a-client.js

@@ -0,0 +1,94 @@
+export class A2AClient {
+    // 向远端 Agent 发送任务
+    async sendTask(target, from, message, callbackUrl) {
+        const rpcReq = {
+            jsonrpc: "2.0",
+            id: Date.now(),
+            method: "message/send",
+            params: { from, message, callbackUrl },
+        };
+        const res = await this.rpcCall(target, rpcReq);
+        if (res.error) {
+            throw new Error(`RPC error: ${res.error.message}`);
+        }
+        return res.result;
+    }
+    // 查询远端任务状态
+    async getTask(target, taskId) {
+        const rpcReq = {
+            jsonrpc: "2.0",
+            id: Date.now(),
+            method: "tasks/get",
+            params: { taskId },
+        };
+        const res = await this.rpcCall(target, rpcReq);
+        if (res.error) {
+            throw new Error(`RPC error: ${res.error.message}`);
+        }
+        return res.result;
+    }
+    // 向发送方回调通知任务状态变更
+    async sendTaskNotification(callbackUrl, task) {
+        const rpcReq = {
+            jsonrpc: "2.0",
+            id: Date.now(),
+            method: "tasks/notify",
+            params: {
+                taskId: task.id,
+                status: task.status,
+                result: task.result,
+                from: task.from,
+                to: task.to,
+            },
+        };
+        try {
+            const res = await fetch(callbackUrl, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify(rpcReq),
+            });
+            if (!res.ok) {
+                console.error(`[a2a-client] 回调通知失败: HTTP ${res.status}`);
+            }
+        }
+        catch (err) {
+            console.error(`[a2a-client] 回调通知失败: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    // 轮询等待任务完成（备用，SSE 不可用时使用）
+    async waitForTask(target, taskId, timeoutMs = 300000, pollIntervalMs = 2000) {
+        const start = Date.now();
+        while (Date.now() - start < timeoutMs) {
+            const task = await this.getTask(target, taskId);
+            if (task.status === "completed" ||
+                task.status === "rejected" ||
+                task.status === "canceled") {
+                return task;
+            }
+            await new Promise((r) => setTimeout(r, pollIntervalMs));
+        }
+        throw new Error(`Task ${taskId} timed out after ${timeoutMs}ms`);
+    }
+    // 获取远端 Agent Card
+    async getAgentCard(target) {
+        const url = `http://${target.host}:${target.port}/.well-known/agent-card.json`;
+        const res = await fetch(url);
+        if (!res.ok) {
+            throw new Error(`Failed to fetch agent card: ${res.status}`);
+        }
+        return (await res.json());
+    }
+    async rpcCall(target, req) {
+        const url = `http://${target.host}:${target.port}/a2a`;
+        const res = await fetch(url, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(req),
+        });
+        if (!res.ok) {
+            throw new Error(`HTTP error: ${res.status}`);
+        }
+        return (await res.json());
+    }
+}
+//# sourceMappingURL=a2a-client.js.map

package/dist/a2a-client.js.map

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

package/dist/a2a-server.d.ts

@@ -0,0 +1,20 @@
+import type { AgentLinkConfig, Task } from "./types.js";
+import type { TaskStore } from "./task-store.js";
+export declare class A2AServer {
+    private server;
+    private config;
+    private taskStore;
+    private onTaskReceived?;
+    private onTaskNotified?;
+    constructor(config: AgentLinkConfig, taskStore: TaskStore);
+    setOnTaskReceived(handler: (task: Task) => void): void;
+    setOnTaskNotified(handler: (task: Partial<Task> & {
+        id: string;
+    }) => void): void;
+    start(): Promise<number>;
+    stop(): Promise<void>;
+    private getAgentCard;
+    private handleRequest;
+    private handleRpc;
+    private readBody;
+}

package/dist/a2a-server.js

@@ -0,0 +1,168 @@
+import http from "node:http";
+export class A2AServer {
+    server;
+    config;
+    taskStore;
+    onTaskReceived;
+    onTaskNotified;
+    constructor(config, taskStore) {
+        this.config = config;
+        this.taskStore = taskStore;
+        this.server = http.createServer(this.handleRequest.bind(this));
+    }
+    setOnTaskReceived(handler) {
+        this.onTaskReceived = handler;
+    }
+    setOnTaskNotified(handler) {
+        this.onTaskNotified = handler;
+    }
+    // 尝试监听指定端口，被占用则自动分配随机端口
+    start() {
+        return new Promise((resolve, reject) => {
+            const tryListen = (port) => {
+                const server = this.server;
+                const onError = (err) => {
+                    if (err.code === "EADDRINUSE") {
+                        // 端口被占用，使用 0 让系统自动分配
+                        server.removeListener("error", onError);
+                        tryListen(0);
+                    }
+                    else {
+                        reject(err);
+                    }
+                };
+                server.once("error", onError);
+                server.listen(port, () => {
+                    server.removeListener("error", onError);
+                    const addr = server.address();
+                    this.config.port = addr.port;
+                    resolve(addr.port);
+                });
+            };
+            tryListen(this.config.port);
+        });
+    }
+    stop() {
+        return new Promise((resolve, reject) => {
+            this.server.close((err) => (err ? reject(err) : resolve()));
+        });
+    }
+    getAgentCard() {
+        return {
+            name: this.config.name,
+            description: `Agent "${this.config.name}" on agent-link network`,
+            url: `http://localhost:${this.config.port}/a2a`,
+            version: "1.0",
+            capabilities: {
+                streaming: false,
+                pushNotifications: false,
+            },
+            skills: this.config.skills,
+        };
+    }
+    async handleRequest(req, res) {
+        // CORS
+        res.setHeader("Access-Control-Allow-Origin", "*");
+        res.setHeader("Access-Control-Allow-Methods", "GET, POST, OPTIONS");
+        res.setHeader("Access-Control-Allow-Headers", "Content-Type");
+        if (req.method === "OPTIONS") {
+            res.writeHead(204);
+            res.end();
+            return;
+        }
+        // Agent Card
+        if (req.method === "GET" &&
+            (req.url === "/.well-known/agent-card.json" || req.url === "/agent-card")) {
+            res.writeHead(200, { "Content-Type": "application/json" });
+            res.end(JSON.stringify(this.getAgentCard()));
+            return;
+        }
+        // A2A JSON-RPC endpoint
+        if (req.method === "POST" && req.url === "/a2a") {
+            const body = await this.readBody(req);
+            try {
+                const rpcReq = JSON.parse(body);
+                const rpcRes = this.handleRpc(rpcReq);
+                res.writeHead(200, { "Content-Type": "application/json" });
+                res.end(JSON.stringify(rpcRes));
+            }
+            catch {
+                res.writeHead(400, { "Content-Type": "application/json" });
+                res.end(JSON.stringify({
+                    jsonrpc: "2.0",
+                    id: null,
+                    error: { code: -32700, message: "Parse error" },
+                }));
+            }
+            return;
+        }
+        res.writeHead(404);
+        res.end("Not found");
+    }
+    handleRpc(req) {
+        switch (req.method) {
+            case "message/send": {
+                const params = req.params;
+                const task = this.taskStore.createTask(params.from, this.config.name, params.message, params.callbackUrl);
+                this.onTaskReceived?.(task);
+                return {
+                    jsonrpc: "2.0",
+                    id: req.id,
+                    result: { taskId: task.id, status: task.status },
+                };
+            }
+            case "tasks/notify": {
+                const params = req.params;
+                this.onTaskNotified?.({
+                    id: params.taskId,
+                    status: params.status,
+                    result: params.result,
+                    from: params.from,
+                    to: params.to,
+                });
+                return { jsonrpc: "2.0", id: req.id, result: { ok: true } };
+            }
+            case "tasks/get": {
+                const params = req.params;
+                const task = this.taskStore.getTask(params.taskId);
+                if (!task) {
+                    return {
+                        jsonrpc: "2.0",
+                        id: req.id,
+                        error: { code: -32001, message: "Task not found" },
+                    };
+                }
+                return { jsonrpc: "2.0", id: req.id, result: task };
+            }
+            case "tasks/cancel": {
+                const params = req.params;
+                const task = this.taskStore.updateTask(params.taskId, {
+                    status: "canceled",
+                });
+                if (!task) {
+                    return {
+                        jsonrpc: "2.0",
+                        id: req.id,
+                        error: { code: -32001, message: "Task not found" },
+                    };
+                }
+                return { jsonrpc: "2.0", id: req.id, result: task };
+            }
+            default:
+                return {
+                    jsonrpc: "2.0",
+                    id: req.id,
+                    error: { code: -32601, message: `Method not found: ${req.method}` },
+                };
+        }
+    }
+    readBody(req) {
+        return new Promise((resolve, reject) => {
+            const chunks = [];
+            req.on("data", (chunk) => chunks.push(chunk));
+            req.on("end", () => resolve(Buffer.concat(chunks).toString()));
+            req.on("error", reject);
+        });
+    }
+}
+//# sourceMappingURL=a2a-server.js.map

package/dist/a2a-server.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,4 @@
+import type { AgentLinkConfig } from "./types.js";
+export declare const DEFAULT_A2A_PORT = 3456;
+export declare const DEFAULT_API_PORT = 3457;
+export declare function parseArgs(args: string[]): AgentLinkConfig;

package/dist/config.js

@@ -0,0 +1,39 @@
+export const DEFAULT_A2A_PORT = 3456;
+export const DEFAULT_API_PORT = 3457;
+export function parseArgs(args) {
+    let name = `agent-${Math.random().toString(36).slice(2, 6)}`;
+    let port = DEFAULT_A2A_PORT;
+    let apiPort = DEFAULT_API_PORT;
+    let relayUrl;
+    const skills = [
+        { id: "general", name: "通用", description: "通用任务处理" },
+    ];
+    for (let i = 0; i < args.length; i++) {
+        switch (args[i]) {
+            case "--name":
+            case "-n":
+                name = args[++i];
+                break;
+            case "--port":
+            case "-p":
+                port = parseInt(args[++i], 10);
+                break;
+            case "--api-port":
+                apiPort = parseInt(args[++i], 10);
+                break;
+            case "--relay":
+            case "-r":
+                relayUrl = args[++i];
+                break;
+            case "--skills":
+            case "-s":
+                skills.length = 0;
+                for (const s of args[++i].split(",")) {
+                    skills.push({ id: s.trim(), name: s.trim(), description: s.trim() });
+                }
+                break;
+        }
+    }
+    return { name, port, apiPort, relayUrl, skills };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC;AACrC,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAErC,MAAM,UAAU,SAAS,CAAC,IAAc;IACtC,IAAI,IAAI,GAAG,SAAS,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IAC7D,IAAI,IAAI,GAAG,gBAAgB,CAAC;IAC5B,IAAI,OAAO,GAAG,gBAAgB,CAAC;IAC/B,IAAI,QAA4B,CAAC;IACjC,MAAM,MAAM,GAA8B;QACxC,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE;KACrD,CAAC;IAEF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,QAAQ,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YAChB,KAAK,QAAQ,CAAC;YACd,KAAK,IAAI;gBACP,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;gBACjB,MAAM;YACR,KAAK,QAAQ,CAAC;YACd,KAAK,IAAI;gBACP,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC/B,MAAM;YACR,KAAK,YAAY;gBACf,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAClC,MAAM;YACR,KAAK,SAAS,CAAC;YACf,KAAK,IAAI;gBACP,QAAQ,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;gBACrB,MAAM;YACR,KAAK,UAAU,CAAC;YAChB,KAAK,IAAI;gBACP,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;gBAClB,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;oBACrC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBACvE,CAAC;gBACD,MAAM;QACV,CAAC;IACH,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AACnD,CAAC"}