agentdial 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,20 @@
+# Changelog
+
+## 1.0.0 (2026-03-28)
+
+Initial release.
+
+### Features
+
+- **Agent Identity Protocol (AIP) v1.0** -- single `IDENTITY.md` file defines agent name, personality, channels, and backend URL with YAML frontmatter
+- **10 channel adapters** -- Telegram, Discord, Slack, SMS, WhatsApp, Email, Voice, Teams, Messenger, Web Widget
+- **Unified gateway** -- normalizes all incoming messages to `GatewayMessage` format and routes to any HTTP agent backend
+- **Per-channel response formatting** -- Markdown for Telegram, embeds for Discord, blocks for Slack, plain text fallback
+- **Interactive setup wizard** -- `agentdial setup` guides through identity creation and channel configuration
+- **Secure credential storage** -- per-channel JSON files in `~/.agentdial/credentials/` with 0600 permissions
+- **Voice support** -- Twilio-based voice calls with speech-to-text and text-to-speech
+- **Rich responses** -- cards with images, action buttons (URL, callback, reply), and metadata
+- **MCP server mode** -- `agentdial mcp-serve` integrates with Claude Code as a tool provider
+- **Channel management CLI** -- add, remove, list, and test channels individually or all at once
+- **Zod-validated schemas** -- all message types, configs, and identity files validated at runtime
+- **Zero lock-in** -- agent backend is any HTTP endpoint that accepts JSON POST requests

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Naman Parikh
+
+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,310 @@
+# agentdial
+
+[![npm version](https://img.shields.io/npm/v/agentdial.svg)](https://www.npmjs.com/package/agentdial)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20WSL-blue.svg)](#supported-channels)
+[![Tests](https://img.shields.io/badge/tests-passing-brightgreen.svg)](#tests)
+[![Downloads](https://img.shields.io/npm/dm/agentdial.svg)](https://www.npmjs.com/package/agentdial)
+
+**Dial your AI agent into every platform.**
+
+One identity file. Seven channels. Zero boilerplate.
+
+```bash
+npx agentdial setup
+```
+
+```
+   ___                    __  ____  _       __
+  / _ |___ ____ ___  ____/ / / __ \(_)___ _/ /
+ / __ / _ `/ -_) _ \/ __/ / / / / / / _ `/ /
+/_/ |_\_, /\__/_//_/\__/_/ /_/ /_/_/\_,_/_/
+     /___/
+
+  v1.0.0 One identity. Every channel.
+
+  ┌────────────────────────────────────────┐
+  │ Agent Identity                         │
+  ├────────────────────────────────────────┤
+  │ Name:     Spark                        │
+  │ Tagline:  Your AI concierge            │
+  │ Backend:  http://localhost:8080/agent   │
+  └────────────────────────────────────────┘
+
+  Channel          Status    Cost     Setup
+  ────────────────  ────────  ───────  ─────
+  Telegram Bot      active   Free     2 min
+  Discord Bot       active   Free     3 min
+  Slack App         ready    Free     5 min
+  SMS (Twilio)      ----     ~$0.01   5 min
+  Web Widget        active   Free     1 min
+```
+
+agentdial gives your AI agent a single identity file (`IDENTITY.md`) and connects it to Telegram, Discord, Slack, SMS, WhatsApp, email, and voice -- through one unified gateway.
+
+## Install
+
+```bash
+npm install -g agentdial
+```
+
+Or run directly:
+
+```bash
+npx agentdial setup
+```
+
+**Requirements:** Node.js >= 18 · **Supports:** macOS, Linux, Windows (WSL)
+
+## Quick Start
+
+Three steps. Two minutes.
+
+```bash
+# 1. Create your agent identity + pick channels
+agentdial setup
+
+# 2. Add a channel (interactive credential prompts)
+agentdial channels add telegram
+
+# 3. Start the gateway
+agentdial serve --agent-url http://localhost:8080/agent
+```
+
+Your agent is now live on Telegram. Add more channels anytime with `agentdial channels add <channel>`.
+
+## Why agentdial?
+
+Every AI agent needs to talk to users. Today that means:
+
+- **5-15 separate API integrations** (Telegram Bot API, Discord.js, Slack SDK, Twilio, SendGrid...)
+- **Hundreds of lines of boilerplate** per channel (webhook setup, message normalization, response formatting)
+- **No standard identity format** -- every platform represents your agent differently
+- **Credential sprawl** -- API keys scattered across env files, dashboards, and config files
+
+agentdial solves this with:
+
+- **One identity file** (`IDENTITY.md`) that defines your agent's name, personality, and channel config
+- **One gateway** that normalizes all incoming messages to a single `GatewayMessage` format
+- **One response format** (`GatewayResponse`) that agentdial translates per-channel (Markdown for Telegram, embeds for Discord, blocks for Slack)
+- **Secure credential storage** in `~/.agentdial/credentials/` with 0600 permissions
+- **Zero lock-in** -- your agent backend is a plain HTTP endpoint that receives JSON
+
+## Supported Channels
+
+| Channel           | Cost           | Setup Time | Credentials Needed         |
+| ----------------- | -------------- | ---------- | -------------------------- |
+| Telegram Bot      | Free           | 2 min      | Bot token from @BotFather  |
+| Discord Bot       | Free           | 3 min      | Bot token + application ID |
+| Slack App         | Free           | 5 min      | Bot token + signing secret |
+| SMS (Twilio)      | ~$0.0079/msg   | 5 min      | Account SID + auth token   |
+| WhatsApp (Twilio) | ~$0.005/msg    | 10 min     | Account SID + auth token   |
+| Email (SendGrid)  | 60-day trial\* | 3 min      | API key + verified sender  |
+| Voice (Twilio)    | ~$0.013/min    | 5 min      | Account SID + auth token   |
+
+Free channels (Telegram, Discord) need zero payment info. Paid channels use Twilio or SendGrid with usage-based pricing. \*SendGrid free tier was removed May 2025; 60-day trial (100 emails/day), then $19.95/mo.
+
+### Coming Soon
+
+| Channel            | Status  |
+| ------------------ | ------- |
+| Microsoft Teams    | Planned |
+| Facebook Messenger | Planned |
+| Web Widget         | Planned |
+
+## Architecture
+
+```
+  Telegram ──┐
+  Discord  ──┤                    ┌──────────────────┐
+  Slack    ──┤   ┌────────────┐   │                  │
+  SMS      ──┼──>│  agentdial │──>│  Your Agent      │
+  WhatsApp ──┤   │  Gateway   │   │  Backend         │
+  Email    ──┤   │  :3141     │   │  (any HTTP)      │
+  Voice    ──┘   └────────────┘   └──────────────────┘
+                       │
+                       │ Normalizes all messages to:
+                       │ { id, channel, from, text, timestamp }
+                       │
+                       │ Formats responses per-channel:
+                       │ Telegram: Markdown + inline keyboards
+                       │ Discord:  Embeds + components
+                       │ Slack:    Blocks + actions
+                       └ Others:   Plain text fallback
+```
+
+The gateway runs on port 3141 by default. Every incoming message from any channel is normalized into a `GatewayMessage`, forwarded to your agent backend as a POST request, and the response is formatted back into the channel's native format.
+
+Your agent backend just needs one endpoint that accepts a JSON body and returns `{ text: "..." }`.
+
+## IDENTITY.md Spec
+
+agentdial introduces the **Agent Identity Protocol (AIP) v1.0** -- a single markdown file that defines your agent across all platforms.
+
+```yaml
+---
+name: spark
+tagline: Your AI concierge
+version: "1.0.0"
+agent_url: http://localhost:8080/agent
+channels:
+  telegram:
+    enabled: true
+    handle: "@spark_bot"
+  discord:
+    enabled: true
+    handle: "Spark#1234"
+  slack:
+    enabled: true
+  web:
+    enabled: true
+---
+
+# Spark
+
+> Your AI concierge
+
+## Personality
+
+- Friendly and knowledgeable
+- Concise but thorough
+- Uses casual tone with professional substance
+
+## Capabilities
+
+- Restaurant recommendations and reservations
+- Event discovery and booking
+- Local area knowledge
+
+## Boundaries
+
+- No financial transactions
+- No medical or legal advice
+- No personal data retention beyond the session
+```
+
+The YAML frontmatter is machine-readable. The markdown body is human-readable context your agent can use as a system prompt. The `channels` block declares which platforms your agent is active on.
+
+## Claude Code Integration
+
+agentdial ships as an MCP server for Claude Code. Add it to your project's `.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "agentdial": {
+      "command": "npx",
+      "args": ["-y", "agentdial", "mcp-serve"]
+    }
+  }
+}
+```
+
+This gives Claude Code tools to manage channels, test connections, and check agent status without leaving the terminal.
+
+Start the MCP server standalone:
+
+```bash
+agentdial mcp-serve
+```
+
+## Voice
+
+Voice channels use Twilio for telephony. Configure with:
+
+```bash
+agentdial voice setup
+```
+
+This prompts for your Twilio Account SID, Auth Token, and phone number. Test with:
+
+```bash
+agentdial voice test --number +15551234567
+```
+
+Voice calls are transcribed to text, sent through the same gateway pipeline as chat messages, and the response is synthesized back to speech via Twilio.
+
+## Configuration
+
+All config and credentials are stored locally:
+
+```
+~/.agentdial/
+├── config.json          # Gateway port, log level, identity file path
+├── credentials/         # Per-channel credential files (0600 permissions)
+│   ├── telegram.json
+│   ├── discord.json
+│   ├── slack.json
+│   └── twilio.json
+├── templates/           # Identity file templates
+└── logs/                # Gateway logs
+```
+
+Example `config.json`:
+
+```json
+{
+  "identityFile": "IDENTITY.md",
+  "gatewayPort": 3141,
+  "logLevel": "info"
+}
+```
+
+Credentials are never stored in your project directory or committed to git. The `credentials/` directory is created with 0700 permissions, and individual credential files with 0600.
+
+## All Commands
+
+```
+SETUP
+  agentdial setup                      Interactive wizard (identity + channels)
+  agentdial setup --file ./agent.md    Use existing identity file
+
+CHANNELS
+  agentdial channels add <channel>     Configure a new channel
+  agentdial channels remove <channel>  Remove a channel
+  agentdial channels list              Show all channels and status
+  agentdial channels test [channel]    Test one or all channels
+
+VOICE
+  agentdial voice setup                Configure Twilio voice
+  agentdial voice test -n <phone>      Test call to a number
+
+GATEWAY
+  agentdial serve                      Start the gateway (port 3141)
+  agentdial serve -p 8080              Custom port
+  agentdial serve -a http://my-agent   Point to agent backend
+
+STATUS
+  agentdial status                     Show all channel statuses
+  agentdial status --json              Machine-readable output
+
+TEST
+  agentdial test                       Send test message through gateway
+  agentdial test -c telegram -m "hi"   Test specific channel
+
+MCP
+  agentdial mcp-serve                  Start as MCP server for Claude Code
+```
+
+## Tests
+
+```bash
+cd tools/agentdial && pnpm test
+```
+
+Tests cover identity parsing/validation, gateway message normalization, response formatting, adapter interface compliance, and Zod schema validation. All tests use mocks -- no real API calls.
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on adding adapters, running tests, and submitting PRs.
+
+## See Also
+
+- **[agentgrid](https://github.com/naman10parikh/agentgrid)** -- Spawn grids of AI coding agents in parallel terminal panes
+- **[Energy](https://github.com/naman10parikh/Energy)** -- Self-improving agent platform. agentdial is part of the Energy toolkit
+- **[Model Context Protocol](https://modelcontextprotocol.io)** -- The MCP standard agentdial integrates with
+- **[Google A2A](https://google.github.io/A2A/)** -- Agent-to-Agent protocol for inter-agent communication
+
+## License
+
+MIT -- see [LICENSE](LICENSE).

package/dist/adapters/discord.d.ts

@@ -0,0 +1,24 @@
+import type { ChannelAdapter, ChannelConfig, ChannelStatus, GatewayMessage, GatewayResponse } from "./types.js";
+export declare class DiscordAdapter implements ChannelAdapter {
+    readonly name: "discord";
+    readonly displayName: string;
+    readonly free = true;
+    readonly setupTime: string;
+    private client;
+    private token;
+    private messageHandler;
+    private connectedAt;
+    private lastMessageAt;
+    private loadDiscordJs;
+    setup(config: ChannelConfig): Promise<void>;
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    send(to: string, response: GatewayResponse): Promise<void>;
+    onMessage(handler: (msg: GatewayMessage) => Promise<GatewayResponse>): void;
+    test(): Promise<{
+        ok: boolean;
+        error?: string;
+    }>;
+    status(): Promise<ChannelStatus>;
+}
+//# sourceMappingURL=discord.d.ts.map

package/dist/adapters/discord.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discord.d.ts","sourceRoot":"","sources":["../../src/adapters/discord.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,aAAa,EACb,cAAc,EACd,eAAe,EAChB,MAAM,YAAY,CAAC;AA+BpB,qBAAa,cAAe,YAAW,cAAc;IACnD,QAAQ,CAAC,IAAI,EAAG,SAAS,CAAU;IACnC,QAAQ,CAAC,WAAW,SAAiC;IACrD,QAAQ,CAAC,IAAI,QAAQ;IACrB,QAAQ,CAAC,SAAS,SAA+B;IAEjD,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,cAAc,CAEN;IAChB,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,aAAa,CAAuB;YAE9B,aAAa;IAgBrB,KAAK,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAW3C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA+CxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ3B,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAchE,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;IAIrE,IAAI,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAehD,MAAM,IAAI,OAAO,CAAC,aAAa,CAAC;CAUvC"}

package/dist/adapters/discord.js

@@ -0,0 +1,129 @@
+import { getCredential, saveCredential } from "../lib/credentials.js";
+import { CHANNEL_DISPLAY_NAMES, CHANNEL_SETUP_TIMES, } from "../lib/constants.js";
+export class DiscordAdapter {
+    name = "discord";
+    displayName = CHANNEL_DISPLAY_NAMES.discord;
+    free = true;
+    setupTime = CHANNEL_SETUP_TIMES.discord;
+    client = null;
+    token = null;
+    messageHandler = null;
+    connectedAt = null;
+    lastMessageAt = null;
+    async loadDiscordJs() {
+        try {
+            const pkg = "discord.js";
+            const mod = (await import(/* webpackIgnore: true */ pkg));
+            return mod;
+        }
+        catch {
+            throw new Error("discord.js not installed. Run: npm install discord.js");
+        }
+    }
+    async setup(config) {
+        const token = config.credentials?.["bot_token"];
+        if (!token)
+            throw new Error("Missing credential: bot_token. Create a bot at discord.com/developers/applications.");
+        await this.loadDiscordJs();
+        this.token = token;
+        await saveCredential("discord", "bot_token", token);
+    }
+    async connect() {
+        if (!this.token) {
+            const stored = await getCredential("discord", "bot_token");
+            if (!stored)
+                throw new Error("Not configured. Run setup() first.");
+            this.token = stored;
+        }
+        const { Client, GatewayIntentBits } = await this.loadDiscordJs();
+        this.client = new Client({
+            intents: [
+                GatewayIntentBits.Guilds,
+                GatewayIntentBits.GuildMessages,
+                GatewayIntentBits.MessageContent,
+            ],
+        });
+        this.client.on("messageCreate", (raw) => {
+            const message = raw;
+            if (message.author.bot || !this.messageHandler)
+                return;
+            this.lastMessageAt = Date.now();
+            const attachments = [...message.attachments.values()].map((a) => ({
+                type: "file",
+                url: a.url,
+                name: a.name,
+                mimeType: a.contentType ?? undefined,
+            }));
+            const msg = {
+                id: message.id,
+                channel: "discord",
+                from: message.author.username,
+                text: message.content,
+                timestamp: message.createdTimestamp,
+                threadId: message.channelId,
+                replyTo: message.reference?.messageId,
+                attachments: attachments.length ? attachments : undefined,
+                metadata: { guildId: message.guildId, channelId: message.channelId },
+            };
+            this.messageHandler(msg)
+                .then((response) => {
+                this.send(message.channelId, response).catch(() => { });
+            })
+                .catch(() => { });
+        });
+        await this.client.login(this.token);
+        this.connectedAt = Date.now();
+    }
+    async disconnect() {
+        if (this.client) {
+            await this.client.destroy();
+            this.client = null;
+        }
+        this.connectedAt = null;
+    }
+    async send(to, response) {
+        if (!this.client)
+            throw new Error("Not connected");
+        const channel = await this.client.channels.fetch(to);
+        let content = response.text;
+        if (response.cards?.length) {
+            for (const card of response.cards) {
+                content += `\n\n**${card.title}**`;
+                if (card.description)
+                    content += `\n${card.description}`;
+            }
+        }
+        if (content.length > 2000)
+            content = content.slice(0, 1997) + "...";
+        await channel.send({ content });
+    }
+    onMessage(handler) {
+        this.messageHandler = handler;
+    }
+    async test() {
+        try {
+            if (!this.client?.isReady())
+                return { ok: false, error: "Bot not connected" };
+            const tag = this.client.user?.tag ?? "unknown";
+            const guilds = this.client.guilds.cache.size;
+            return { ok: true, error: undefined };
+        }
+        catch (err) {
+            return {
+                ok: false,
+                error: err instanceof Error ? err.message : "Unknown error",
+            };
+        }
+    }
+    async status() {
+        const connected = this.client?.isReady() ?? false;
+        return {
+            channel: "discord",
+            connected,
+            latencyMs: connected ? this.client.ws.ping : null,
+            lastMessage: this.lastMessageAt,
+            error: connected ? null : "Not connected",
+        };
+    }
+}
+//# sourceMappingURL=discord.js.map

package/dist/adapters/discord.js.map

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

package/dist/adapters/email.d.ts

@@ -0,0 +1,38 @@
+import type { ChannelAdapter, ChannelConfig, ChannelStatus, GatewayMessage, GatewayResponse } from "./types.js";
+interface InboundParsePayload {
+    from: string;
+    to: string;
+    subject: string;
+    text: string;
+    html?: string;
+    attachments?: string;
+    "attachment-info"?: string;
+    [key: string]: string | undefined;
+}
+export declare class EmailAdapter implements ChannelAdapter {
+    readonly name: "email";
+    readonly displayName = "Email (SendGrid)";
+    readonly free = false;
+    readonly cost = "100/day free, then $0.001/msg";
+    readonly setupTime = "3 min";
+    private apiKey;
+    private fromEmail;
+    private fromName;
+    private messageHandler;
+    private connected;
+    private lastMessageTs;
+    setup(config: ChannelConfig): Promise<void>;
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    send(to: string, response: GatewayResponse): Promise<void>;
+    onMessage(handler: (msg: GatewayMessage) => Promise<GatewayResponse>): void;
+    /** Call from HTTP webhook handler with parsed SendGrid Inbound Parse POST body. */
+    handleWebhook(payload: InboundParsePayload): Promise<GatewayResponse | null>;
+    test(): Promise<{
+        ok: boolean;
+        error?: string;
+    }>;
+    status(): Promise<ChannelStatus>;
+}
+export {};
+//# sourceMappingURL=email.d.ts.map

package/dist/adapters/email.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.d.ts","sourceRoot":"","sources":["../../src/adapters/email.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,aAAa,EACb,cAAc,EACd,eAAe,EAChB,MAAM,YAAY,CAAC;AAapB,UAAU,mBAAmB;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACnC;AA+DD,qBAAa,YAAa,YAAW,cAAc;IACjD,QAAQ,CAAC,IAAI,EAAG,OAAO,CAAU;IACjC,QAAQ,CAAC,WAAW,sBAAsB;IAC1C,QAAQ,CAAC,IAAI,SAAS;IACtB,QAAQ,CAAC,IAAI,mCAAmC;IAChD,QAAQ,CAAC,SAAS,WAAW;IAE7B,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,SAAS,CAAM;IACvB,OAAO,CAAC,QAAQ,CAAM;IACtB,OAAO,CAAC,cAAc,CAEN;IAChB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,aAAa,CAAuB;IAEtC,KAAK,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IA0B3C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAMxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BhE,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;IAI3E,mFAAmF;IAC7E,aAAa,CACjB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAwB5B,IAAI,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAehD,MAAM,IAAI,OAAO,CAAC,aAAa,CAAC;CAqBvC"}