agent-comms 1.0.14 → 1.2.0

package/.claude-plugin/marketplace.json

@@ -0,0 +1,21 @@
+{
+	"name": "agent-comms",
+	"owner": {
+		"name": "ExaDev"
+	},
+	"metadata": {
+		"description": "Cross-harness communication bus for LLM agents",
+		"homepage": "https://github.com/ExaDev/agent-comms#readme"
+	},
+	"plugins": [
+		{
+			"name": "agent-comms",
+			"source": {
+				"source": "url",
+				"url": "https://github.com/ExaDev/agent-comms.git"
+			},
+			"description": "Cross-harness LLM agent communication bus — rooms, DMs, and presence",
+			"version": "1.1.0"
+		}
+	]
+}

package/.claude-plugin/plugin.json

@@ -0,0 +1,21 @@
+{
+  "name": "agent-comms",
+  "description": "Cross-harness LLM agent communication bus — rooms, DMs, and presence",
+  "version": "1.2.0",
+  "author": {
+    "name": "ExaDev"
+  },
+  "homepage": "https://github.com/ExaDev/agent-comms#readme",
+  "repository": "https://github.com/ExaDev/agent-comms",
+  "license": "MIT",
+  "mcpServers": {
+    "agent-comms": {
+      "command": "npx",
+      "args": [
+        "agent-comms",
+        "bridge",
+        "claude-code"
+      ]
+    }
+  }
+}

package/README.md

@@ -1,23 +1,76 @@
 # Agent Comms
 
-Cross-harness communication bus for LLM agents. Rooms, DMs, presence, and visibility — all via a shared filesystem protocol. No server process required.
+Cross-harness communication bus for LLM agents. Rooms, DMs, presence, and visibility — via a TCP peer mesh with zero filesystem dependencies.
 
 ## How it works
 
+Each bridge instance is a peer in a TCP mesh on localhost. The first instance to start becomes the **coordinator** (port 19876). Subsequent instances connect to the coordinator, receive the peer list, and establish direct data connections with every other peer.
+
 ```
-~/.agents/bus/              ← shared filesystem (no server process)
-├── registry/
-│   ├── agents/*.json       ← agent identities, visibility, status
-│   └── rooms/*.json        ← room definitions, membership
-├── rooms/{id}/*.json       ← room message history
-├── dms/{a}--{b}/*.json     ← direct message history
-└── delivery/{id}/*.json    ← per-agent push queue (drained by bridges)
+Agent A (pi)                          Agent B (Claude Code)
+   │                                       │
+   │  pi bridge  ◀──TCP localhost──▶  Claude bridge
+   │      │                                │
+   │  agent_comms(                    channel notification
+   │    "send",                             │
+   │    ...                           Claude surfaces it
+   │  )                                to the LLM
+   │      │
+   │  push to B's bridge ───────────▶ handled
 ```
 
-Every operation is a file read/write. A bridge translates file changes into its harness's native push mechanism — the core knows nothing about which harnesses exist.
+All state is held in memory and synchronised between peers. Delivery events are pushed directly over TCP — no polling, no filesystem, no daemon process.
+
+### Coordinator pattern
+
+- **Well-known port** 19876 on localhost — the only agreed-upon constant
+- The first instance to bind it becomes coordinator
+- Coordinator handles introductions only — not a router
+- On graceful shutdown, coordinator hands over to the longest-running peer
+- On crash, remaining peers race to bind the port (~100ms recovery)
+
+### Identity
+
+Each instance gets a unique peer ID on startup. Mesh state is in-memory — when a process exits, its peer is gone. Identity is not persisted because the mesh state dies with the process.
 
 ## Install
 
+### pi
+
+```bash
+pi install npm:agent-comms
+```
+
+The [`pi` manifest](/package.json) registers the extension automatically.
+
+### Claude Code
+
+```bash
+claude plugin marketplace add https://github.com/ExaDev/agent-comms
+claude plugin install agent-comms@agent-comms
+```
+
+This repo serves as its own marketplace. The [plugin manifest](/.claude-plugin/plugin.json) defines the MCP server.
+
+### Any MCP-compatible harness
+
+Add to your MCP server configuration:
+
+```json
+{
+  "mcpServers": {
+    "agent-comms": {
+      "command": "npx",
+      "args": ["agent-comms", "bridge", "mcp"]
+    }
+  }
+}
+```
+
+The generic MCP bridge works with any MCP client. Incoming messages are included in every tool response.
+
+### Other harnesses
+
 ```bash
 npx agent-comms                         # auto-detect harnesses and configure
 npx agent-comms status                  # check current configuration
@@ -50,21 +103,30 @@ A bridge is two things:
 Core provides shared helpers so each bridge only implements those two things:
 
 ```typescript
-import { BusStore, BusTool, buildAction, ensureRegistered, drainAndFormat } from "agent-comms";
-
-const store = new BusStore();
-const tool = new BusTool(store);
-
-// 1. Register or recover identity
+import {
+  MeshStore,
+  CommsTool,
+  buildAction,
+  ensureRegistered,
+  formatDeliveryEvent,
+} from "agent-comms";
+
+const store = new MeshStore();
+const tool = new CommsTool(store);
+
+// 1. Initialise mesh and register identity
+await store.init();
 const { agentId } = await ensureRegistered({ store, harness: "my-harness", defaultName: "my-agent" });
 
-// 2. Wire tool into your harness
-const action = buildAction(paramsFromToolCall);
-const result = await tool.handle({ agentId, harness: "my-harness", pid: process.pid }, action);
+// 2. Wire delivery callback for real-time push
+store.onDelivery = (_targetId, event) => {
+  const line = formatDeliveryEvent(event);
+  yourHarness.push(`📬 ${line}`);
+};
 
-// 3. Push delivery events when the LLM finishes a turn
-const lines = await drainAndFormat(store, agentId);
-for (const line of lines) await yourHarness.push(`📬 ${line}`);
+// 3. Wire tool into your harness
+const action = buildAction(paramsFromToolCall);
+const result = await tool.handle({ agentId, harness: "my-harness", cwd: process.cwd(), pid: process.pid }, action);
 ```
 
 See `src/bridges/` for working examples.
@@ -112,4 +174,3 @@ agent_comms({ action: "update", visibility: "hidden" })
 | `visible` | ✓ | ✓ | ✓ |
 | `hidden` | ✗ | ✓ (if ID known) | Members only |
 | `ghost` | ✗ | ✗ | ✗ |
-

package/dist/bridges/claude-code/channel.d.ts

@@ -3,6 +3,7 @@
  *
  * MCP channel server that provides the "agent_comms" tool and pushes
  * incoming messages into Claude's context via <channel> events.
+ * Uses TCP mesh for real-time delivery — no filesystem polling.
  *
  * Run via: npx agent-comms bridge claude-code
  * Requires: claude --dangerously-load-development-channels

package/dist/bridges/claude-code/channel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../../../src/bridges/claude-code/channel.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAqBH,wBAAsB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAyGzC"}
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../../../src/bridges/claude-code/channel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAmBH,wBAAsB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAuFzC"}

package/dist/bridges/claude-code/channel.js

@@ -3,50 +3,35 @@
  *
  * MCP channel server that provides the "agent_comms" tool and pushes
  * incoming messages into Claude's context via <channel> events.
+ * Uses TCP mesh for real-time delivery — no filesystem polling.
  *
  * Run via: npx agent-comms bridge claude-code
  * Requires: claude --dangerously-load-development-channels
  */
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import * as path from "node:path";
-import * as os from "node:os";
-import { BusStore, BusTool, buildAction, ensureRegistered, drainAndFormat, MCP_TOOL_PARAMS, } from "../../core/index.js";
+import { MeshStore, CommsTool, buildAction, ensureRegistered, formatDeliveryEvent, MCP_TOOL_PARAMS, } from "../../core/index.js";
 import { nanoid } from "../../core/nanoid.js";
 function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 export async function run() {
-    const store = new BusStore(path.join(os.homedir(), ".agents", "bus"));
-    const tool = new BusTool(store);
+    const store = new MeshStore();
+    const tool = new CommsTool(store);
     let agentId;
-    let watchTimer;
     const mcp = new McpServer({ name: "agent-comms", version: "0.2.0" }, {
         capabilities: {
             experimental: { "claude/channel": {} },
         },
     });
-    // -----------------------------------------------------------------------
-    // Delivery polling (channels can't use fs.watch easily)
-    // -----------------------------------------------------------------------
-    function startDeliveryPoll() {
-        if (watchTimer)
-            return;
-        watchTimer = setInterval(() => {
-            void pollDelivery();
-        }, 2000);
-    }
-    async function pollDelivery() {
-        if (!agentId)
-            return;
-        const lines = await drainAndFormat(store, agentId);
-        for (const line of lines) {
-            await mcp.server.notification({
-                method: "notifications/claude/channel",
-                params: { content: line, meta: {} },
-            });
-        }
-    }
+    // Incoming messages arrive via TCP mesh — push as channel notifications
+    store.onDelivery = async (_targetId, event) => {
+        const line = formatDeliveryEvent(event);
+        await mcp.server.notification({
+            method: "notifications/claude/channel",
+            params: { content: line, meta: {} },
+        });
+    };
     // -----------------------------------------------------------------------
     // Tool registration
     // -----------------------------------------------------------------------
@@ -61,21 +46,17 @@ export async function run() {
     }, async (rawParams) => {
         const params = isRecord(rawParams) ? rawParams : {};
         const actionParam = params.action;
-        if (!agentId && actionParam !== "register") {
+        if (!agentId) {
+            const name = actionParam === "register" && typeof params.name === "string"
+                ? params.name
+                : `claude-code-${nanoid(4)}`;
             const reg = await ensureRegistered({
                 cwd: process.cwd(),
                 store,
                 harness: "claude-code",
-                defaultName: `claude-code-${nanoid(4)}`,
+                defaultName: name,
             });
             agentId = reg.agentId;
-            startDeliveryPoll();
-        }
-        if (!agentId) {
-            return {
-                content: [{ type: "text", text: "Error: failed to register" }],
-                isError: true,
-            };
         }
         const action = buildAction(params);
         const result = await tool.handle({
@@ -92,6 +73,7 @@ export async function run() {
     // -----------------------------------------------------------------------
     // Startup
     // -----------------------------------------------------------------------
+    await store.init();
     await mcp.connect(new StdioServerTransport());
     const reg = await ensureRegistered({
         cwd: process.cwd(),
@@ -100,6 +82,5 @@ export async function run() {
         defaultName: `claude-code-${nanoid(4)}`,
     });
     agentId = reg.agentId;
-    startDeliveryPoll();
 }
 //# sourceMappingURL=channel.js.map

package/dist/bridges/claude-code/channel.js.map

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

package/dist/bridges/codex/tool.d.ts

@@ -2,7 +2,8 @@
  * Agent Comms — Codex MCP tool server.
  *
  * Provides the "agent_comms" tool for Codex to call.
- * Push delivery is handled by the Stop hook (stop_hook.ts).
+ * Uses TCP mesh for state sync. Pending messages are drained and
+ * appended to every tool response so Codex sees them mid-turn.
  *
  * Run via: npx agent-comms bridge codex
  */

package/dist/bridges/codex/tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../../src/bridges/codex/tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAoBH,wBAAsB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAuEzC"}
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../../src/bridges/codex/tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAmBH,wBAAsB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CA+EzC"}

package/dist/bridges/codex/tool.js

@@ -2,22 +2,21 @@
  * Agent Comms — Codex MCP tool server.
  *
  * Provides the "agent_comms" tool for Codex to call.
- * Push delivery is handled by the Stop hook (stop_hook.ts).
+ * Uses TCP mesh for state sync. Pending messages are drained and
+ * appended to every tool response so Codex sees them mid-turn.
  *
  * Run via: npx agent-comms bridge codex
  */
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import * as path from "node:path";
-import * as os from "node:os";
-import { BusStore, BusTool, buildAction, ensureRegistered, MCP_TOOL_PARAMS, } from "../../core/index.js";
+import { MeshStore, CommsTool, buildAction, ensureRegistered, drainAndFormat, MCP_TOOL_PARAMS, } from "../../core/index.js";
 import { nanoid } from "../../core/nanoid.js";
 function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 export async function run() {
-    const store = new BusStore(path.join(os.homedir(), ".agents", "bus"));
-    const tool = new BusTool(store);
+    const store = new MeshStore();
+    const tool = new CommsTool(store);
     let agentId;
     const mcp = new McpServer({ name: "agent-comms", version: "0.2.0" }, { capabilities: {} });
     // -----------------------------------------------------------------------
@@ -28,37 +27,43 @@ export async function run() {
             "Cross-harness agent communication bus. Actions:",
             "register, update, whoami, create_room, list_rooms, join_room, leave_room,",
             "send, dm, list_agents, read_room, invite, kick, destroy_room.",
-            "Incoming messages are delivered automatically via the Stop hook.",
+            "Pending incoming messages are included in every response.",
         ].join(" "),
         inputSchema: MCP_TOOL_PARAMS,
     }, async (rawParams) => {
         const params = isRecord(rawParams) ? rawParams : {};
         const actionParam = params.action;
-        if (!agentId && actionParam !== "register") {
+        if (!agentId) {
+            const name = actionParam === "register" && typeof params.name === "string"
+                ? params.name
+                : `codex-${nanoid(4)}`;
             const reg = await ensureRegistered({
                 cwd: process.cwd(),
                 store,
                 harness: "codex",
-                defaultName: `codex-${nanoid(4)}`,
+                defaultName: name,
             });
             agentId = reg.agentId;
         }
-        if (!agentId) {
-            return {
-                content: [{ type: "text", text: "Error: failed to register" }],
-                isError: true,
-            };
-        }
         const action = buildAction(params);
         const result = await tool.handle({ agentId, harness: "codex", cwd: process.cwd(), pid: process.pid }, action);
-        return {
-            content: [{ type: "text", text: result.content }],
-            isError: result.isError,
-        };
+        // Drain pending delivery messages and append to response
+        const deliveryLines = await drainAndFormat(store, agentId);
+        const content = [
+            { type: "text", text: result.content },
+        ];
+        if (deliveryLines.length > 0) {
+            content.push({
+                type: "text",
+                text: "📬 Incoming messages:\n" + deliveryLines.join("\n"),
+            });
+        }
+        return { content, isError: result.isError };
     });
     // -----------------------------------------------------------------------
     // Startup
     // -----------------------------------------------------------------------
+    await store.init();
     await mcp.connect(new StdioServerTransport());
     const reg = await ensureRegistered({
         cwd: process.cwd(),

package/dist/bridges/codex/tool.js.map

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

package/dist/bridges/index.js

@@ -1,9 +1,9 @@
 import * as claudeCode from "./claude-code/channel.js";
 import * as codex from "./codex/tool.js";
-import * as codexStop from "./codex/stop_hook.js";
+import * as mcp from "./mcp/index.js";
 export const bridges = {
     "claude-code": claudeCode,
     codex,
-    "codex-stop": codexStop,
+    mcp,
 };
 //# sourceMappingURL=index.js.map

package/dist/bridges/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/bridges/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,0BAA0B,CAAC;AACvD,OAAO,KAAK,KAAK,MAAM,iBAAiB,CAAC;AACzC,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAMlD,MAAM,CAAC,MAAM,OAAO,GAA2B;IAC7C,aAAa,EAAE,UAAU;IACzB,KAAK;IACL,YAAY,EAAE,SAAS;CACxB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/bridges/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,0BAA0B,CAAC;AACvD,OAAO,KAAK,KAAK,MAAM,iBAAiB,CAAC;AACzC,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AAMtC,MAAM,CAAC,MAAM,OAAO,GAA2B;IAC7C,aAAa,EAAE,UAAU;IACzB,KAAK;IACL,GAAG;CACJ,CAAC"}

package/dist/bridges/mcp/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Agent Comms — generic MCP tool server.
+ *
+ * Standard MCP server that works with any MCP-compatible harness.
+ * Uses TCP mesh for state sync. Pending messages are drained and
+ * appended to every tool response so the agent sees them.
+ *
+ * Run via: npx agent-comms bridge mcp
+ */
+export declare function run(): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/bridges/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/bridges/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAmBH,wBAAsB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAgFzC"}

package/dist/bridges/mcp/index.js

@@ -0,0 +1,76 @@
+/**
+ * Agent Comms — generic MCP tool server.
+ *
+ * Standard MCP server that works with any MCP-compatible harness.
+ * Uses TCP mesh for state sync. Pending messages are drained and
+ * appended to every tool response so the agent sees them.
+ *
+ * Run via: npx agent-comms bridge mcp
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { MeshStore, CommsTool, buildAction, ensureRegistered, drainAndFormat, MCP_TOOL_PARAMS, } from "../../core/index.js";
+import { nanoid } from "../../core/nanoid.js";
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export async function run() {
+    const store = new MeshStore();
+    const tool = new CommsTool(store);
+    let agentId;
+    const mcp = new McpServer({ name: "agent-comms", version: "1.1.0" }, { capabilities: {} });
+    // -----------------------------------------------------------------------
+    // Tool registration
+    // -----------------------------------------------------------------------
+    mcp.registerTool("agent_comms", {
+        description: [
+            "Cross-harness agent communication bus. Actions:",
+            "register, update, whoami, create_room, list_rooms, join_room, leave_room,",
+            "send, dm, list_agents, read_room, invite, kick, destroy_room.",
+            "Pending incoming messages are included in every response.",
+        ].join(" "),
+        inputSchema: MCP_TOOL_PARAMS,
+    }, async (rawParams) => {
+        const params = isRecord(rawParams) ? rawParams : {};
+        const actionParam = params.action;
+        if (!agentId) {
+            const name = actionParam === "register" && typeof params.name === "string"
+                ? params.name
+                : `mcp-${nanoid(4)}`;
+            const reg = await ensureRegistered({
+                cwd: process.cwd(),
+                store,
+                harness: "mcp",
+                defaultName: name,
+            });
+            agentId = reg.agentId;
+        }
+        const action = buildAction(params);
+        const result = await tool.handle({ agentId, harness: "mcp", cwd: process.cwd(), pid: process.pid }, action);
+        // Drain pending delivery messages and append to response
+        const deliveryLines = await drainAndFormat(store, agentId);
+        const content = [
+            { type: "text", text: result.content },
+        ];
+        if (deliveryLines.length > 0) {
+            content.push({
+                type: "text",
+                text: "📬 Incoming messages:\n" + deliveryLines.join("\n"),
+            });
+        }
+        return { content, isError: result.isError };
+    });
+    // -----------------------------------------------------------------------
+    // Startup
+    // -----------------------------------------------------------------------
+    await store.init();
+    await mcp.connect(new StdioServerTransport());
+    const reg = await ensureRegistered({
+        cwd: process.cwd(),
+        store,
+        harness: "mcp",
+        defaultName: `mcp-${nanoid(4)}`,
+    });
+    agentId = reg.agentId;
+}
+//# sourceMappingURL=index.js.map

package/dist/bridges/mcp/index.js.map

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

package/dist/bridges/opencode/plugin.d.ts

@@ -1,8 +1,8 @@
 /**
  * Agent Comms — OpenCode plugin bridge.
  *
- * Drains delivery queue on session.idle and injects messages via
- * tui.prompt.append + tui.submitPrompt.
+ * Receives incoming messages via TCP mesh push and injects them
+ * into the OpenCode TUI via tui.prompt.append + tui.submitPrompt.
  *
  * Install (project):  ln -s ~/Developer/agent-comms/src/bridges/opencode/plugin.ts .opencode/plugins/agent-comms.ts
  * Install (global):   ln -s ~/Developer/agent-comms/src/bridges/opencode/plugin.ts ~/.config/opencode/plugins/agent-comms.ts

package/dist/bridges/opencode/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/bridges/opencode/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAqCH,eAAO,MAAM,gBAAgB,GAAU,MAAM;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,CAAC,EAAE,OAAO,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;uBA6C4B;QAAE,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE;EAMvD,CAAC"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/bridges/opencode/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAiCH,eAAO,MAAM,gBAAgB,GAAU,MAAM;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,CAAC,EAAE,OAAO,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;uBAuC4B;QAAE,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE;EAgBvD,CAAC"}