ccgateway 0.1.0

package/dist/migrate.js

@@ -0,0 +1,356 @@
+import { readFile, writeFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { saveConfig, ensureDirectories, getCcgHome } from './config.js';
+// ── Migration ───────────────────────────────────────────────────────────────
+const DEFAULT_ALLOWED_TOOLS = ['Edit', 'Read', 'Write', 'Bash', 'Grep', 'Glob'];
+/**
+ * Strip provider prefix from a model name.
+ * e.g. "anthropic/claude-opus-4-6" -> "claude-opus-4-6"
+ */
+export function stripModelPrefix(model) {
+    const slashIndex = model.indexOf('/');
+    if (slashIndex === -1)
+        return model;
+    return model.slice(slashIndex + 1);
+}
+/**
+ * Generate a Discord bot token env var name.
+ * e.g. "ginger" -> "DISCORD_GINGER_TOKEN"
+ */
+export function botTokenEnvVar(accountName) {
+    return `DISCORD_${accountName.toUpperCase()}_TOKEN`;
+}
+/**
+ * Migrate from OpenClaw configuration to ccgateway config.
+ */
+export async function migrateFromOpenClaw(options = {}) {
+    // 1. Find openclaw.json
+    const configFile = options.configPath || join(homedir(), '.openclaw', 'openclaw.json');
+    if (!existsSync(configFile)) {
+        throw new Error(`OpenClaw config not found at: ${configFile}\n` +
+            `Specify the path with: ccg migrate openclaw --config <path>`);
+    }
+    // 2. Read and parse
+    const raw = await readFile(configFile, 'utf-8');
+    const ocConfig = JSON.parse(raw);
+    // 3. Extract agents
+    const agents = extractAgents(ocConfig);
+    // 4. Extract bindings
+    const bindings = extractBindings(ocConfig, agents);
+    // 5. Extract bot tokens + generate .env and plugin config
+    const { envLines, pluginBots, instructions: tokenInstructions } = extractBotTokens(ocConfig);
+    // 6. Extract guild ID for Discord plugin config
+    const guildId = extractGuildId(ocConfig);
+    // 7. Build Discord gateway plugin entry if we have bots
+    const plugins = [];
+    if (Object.keys(pluginBots).length > 0) {
+        plugins.push({
+            name: 'discord-gateway',
+            enabled: true,
+            config: {
+                bots: pluginBots,
+                guild: guildId || '',
+                allowedUsers: extractAllowedUsers(ocConfig),
+                commands: ['/new', '/reset', '/status'],
+            },
+        });
+    }
+    // 8. Extract heartbeats from cron/jobs.json
+    const cronPath = join(options.configPath
+        ? join(options.configPath, '..', 'cron', 'jobs.json')
+        : join(homedir(), '.openclaw', 'cron', 'jobs.json'));
+    const heartbeats = await extractHeartbeats(cronPath);
+    // 9. Build ccgateway config
+    const ccgConfig = {
+        agents,
+        bindings,
+        plugins,
+        heartbeats,
+    };
+    // 10. Print summary
+    console.log('--- OpenClaw Migration Summary ---');
+    console.log(`  Agents:     ${agents.length}`);
+    console.log(`  Bindings:   ${bindings.length}`);
+    console.log(`  Plugins:    ${plugins.length}`);
+    console.log(`  Heartbeats: ${heartbeats.length}`);
+    console.log();
+    if (agents.length > 0) {
+        console.log('Agents:');
+        for (const a of agents) {
+            console.log(`  ${a.emoji || '-'} ${a.id} (${a.name}) — model: ${a.model}, workspace: ${a.workspace}`);
+        }
+        console.log();
+    }
+    if (bindings.length > 0) {
+        console.log('Bindings:');
+        for (const b of bindings) {
+            console.log(`  ${b.agent} <- ${b.gateway}:${b.channel} (bot: ${b.bot})`);
+        }
+        console.log();
+    }
+    if (plugins.length > 0) {
+        console.log('Plugins:');
+        for (const p of plugins) {
+            console.log(`  ${p.name} (${p.enabled ? 'enabled' : 'disabled'})`);
+        }
+        console.log();
+    }
+    if (heartbeats.length > 0) {
+        console.log('Heartbeats:');
+        for (const h of heartbeats) {
+            console.log(`  ${h.agent}: ${h.cron} (${h.tz})`);
+        }
+        console.log();
+    }
+    if (envLines.length > 0) {
+        console.log(`Bot tokens found: ${envLines.length}`);
+        for (const line of tokenInstructions) {
+            console.log(line);
+        }
+        console.log();
+    }
+    // 11. Dry run check
+    if (options.dryRun) {
+        console.log('[dry-run] No files were written.');
+        return;
+    }
+    // 12. Save config, .env, and ensure directories
+    await ensureDirectories();
+    await saveConfig(ccgConfig);
+    const home = getCcgHome();
+    // Write .env with actual bot tokens
+    if (envLines.length > 0) {
+        const envPath = join(home, '.env');
+        await writeFile(envPath, envLines.join('\n') + '\n', 'utf-8');
+        console.log(`Bot tokens written to: ${envPath}`);
+    }
+    console.log(`Config written to: ${join(home, 'config.json')}`);
+    console.log();
+    console.log('To start ccgateway, load the .env first:');
+    console.log(`  source ${join(home, '.env')} && ccg start`);
+    console.log();
+    console.log('Migration complete.');
+}
+// ── Extraction helpers ──────────────────────────────────────────────────────
+function extractAgents(config) {
+    const list = config.agents?.list;
+    if (!list || list.length === 0)
+        return [];
+    const defaults = config.agents?.defaults;
+    const defaultModel = defaults?.model?.primary || 'claude-sonnet-4-6';
+    const defaultWorkspace = defaults?.workspace || homedir();
+    const defaultMaxConcurrent = defaults?.maxConcurrent || 4;
+    return list.map((agent) => {
+        // Determine model: agent-level override or default
+        const rawModel = agent.model?.primary || defaultModel;
+        const model = stripModelPrefix(rawModel);
+        // Determine workspace: agent-level override or default
+        const workspace = agent.workspace || defaultWorkspace;
+        // Agent name: identity.name or the agent id
+        const name = agent.identity?.name || agent.name || agent.id;
+        // Emoji
+        const emoji = agent.identity?.emoji || '';
+        return {
+            id: agent.id,
+            name,
+            emoji,
+            workspace,
+            model,
+            skills: [],
+            allowedTools: [...DEFAULT_ALLOWED_TOOLS],
+            maxConcurrentSessions: defaultMaxConcurrent,
+        };
+    });
+}
+function extractBindings(config, agents) {
+    const bindings = [];
+    const seen = new Set();
+    // 1. Extract from explicit bindings array
+    const ocBindings = config.bindings;
+    if (ocBindings) {
+        for (const binding of ocBindings) {
+            const key = `${binding.match.channel}:${binding.match.peer.id}:${binding.match.accountId}`;
+            if (!seen.has(key)) {
+                seen.add(key);
+                bindings.push({
+                    agent: binding.agentId,
+                    gateway: binding.match.channel,
+                    channel: binding.match.peer.id,
+                    bot: binding.match.accountId,
+                });
+            }
+        }
+    }
+    // 2. Extract from channels.discord.accounts.{bot}.guilds.{guild}.channels
+    //    This catches channels that aren't in the bindings array
+    const accounts = config.channels?.discord?.accounts;
+    if (accounts) {
+        // Build a map of bot → agent (first matching agent for each bot)
+        const botToAgent = new Map();
+        for (const agent of agents) {
+            // Check if any existing binding maps this bot to an agent
+            const existing = bindings.find((b) => b.bot === agent.id);
+            if (existing) {
+                botToAgent.set(agent.id, existing.agent);
+            }
+        }
+        // Also check explicit bindings for bot→agent mapping
+        if (ocBindings) {
+            for (const b of ocBindings) {
+                botToAgent.set(b.match.accountId, b.agentId);
+            }
+        }
+        for (const [botName, acct] of Object.entries(accounts)) {
+            const guilds = acct.guilds;
+            if (!guilds)
+                continue;
+            const agentId = botToAgent.get(botName);
+            if (!agentId)
+                continue;
+            for (const guild of Object.values(guilds)) {
+                const channels = guild.channels;
+                if (!channels)
+                    continue;
+                for (const [chId, chConf] of Object.entries(channels)) {
+                    if (!chConf.enabled)
+                        continue;
+                    const key = `discord:${chId}:${botName}`;
+                    if (!seen.has(key)) {
+                        seen.add(key);
+                        bindings.push({
+                            agent: agentId,
+                            gateway: 'discord',
+                            channel: chId,
+                            bot: botName,
+                        });
+                    }
+                }
+            }
+        }
+    }
+    return bindings;
+}
+function extractBotTokens(config) {
+    const accounts = config.channels?.discord?.accounts;
+    if (!accounts)
+        return { envLines: [], pluginBots: {}, instructions: [] };
+    const envLines = [];
+    const pluginBots = {};
+    const instructions = [];
+    for (const [name, account] of Object.entries(accounts)) {
+        const envVar = botTokenEnvVar(name);
+        if (account.token) {
+            envLines.push(`export ${envVar}=${account.token}`);
+            pluginBots[name] = { token: `$${envVar}` };
+            instructions.push(`  ${envVar} → ${name} bot`);
+        }
+    }
+    return { envLines, pluginBots, instructions };
+}
+function extractGuildId(config) {
+    const accounts = config.channels?.discord?.accounts;
+    if (!accounts)
+        return undefined;
+    // Take the first guild ID found across any account
+    for (const account of Object.values(accounts)) {
+        const guilds = account.guilds;
+        if (guilds) {
+            const firstGuildId = Object.keys(guilds)[0];
+            if (firstGuildId)
+                return firstGuildId;
+        }
+    }
+    return undefined;
+}
+function extractAllowedUsers(config) {
+    const accounts = config.channels?.discord?.accounts;
+    if (!accounts)
+        return [];
+    // Collect unique user IDs from all guild user lists
+    const users = new Set();
+    for (const account of Object.values(accounts)) {
+        const guilds = account.guilds;
+        if (guilds) {
+            for (const guild of Object.values(guilds)) {
+                const guildUsers = guild.users;
+                if (guildUsers) {
+                    for (const u of guildUsers)
+                        users.add(u);
+                }
+            }
+        }
+    }
+    return [...users];
+}
+async function extractHeartbeats(cronPath) {
+    if (!existsSync(cronPath))
+        return [];
+    try {
+        const raw = await readFile(cronPath, 'utf-8');
+        const data = JSON.parse(raw);
+        const jobs = data.jobs;
+        if (!jobs || jobs.length === 0)
+            return [];
+        // Only extract enabled cron-type jobs (not one-shot "at" jobs)
+        return jobs
+            .filter((job) => job.enabled && job.schedule.kind === 'cron' && job.schedule.expr)
+            .map((job) => ({
+            agent: job.agentId,
+            cron: job.schedule.expr,
+            tz: job.schedule.tz || 'UTC',
+        }));
+    }
+    catch {
+        return [];
+    }
+}
+// ── Init ────────────────────────────────────────────────────────────────────
+/**
+ * Interactive setup for new users (no OpenClaw).
+ * Creates the ~/.ccgateway/ structure with a minimal starter config.
+ */
+export async function initNew() {
+    const { createInterface } = await import('node:readline');
+    const rl = createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    const ask = (question) => new Promise((resolve) => {
+        rl.question(question, (answer) => resolve(answer.trim()));
+    });
+    console.log('--- ccgateway init ---');
+    console.log('Setting up a new ccgateway configuration.\n');
+    const agentName = (await ask('First agent name [assistant]: ')) || 'assistant';
+    const agentId = agentName.toLowerCase().replace(/\s+/g, '-');
+    const workspace = (await ask(`Workspace directory [${process.cwd()}]: `)) || process.cwd();
+    const model = (await ask('Model [claude-sonnet-4-6]: ')) || 'claude-sonnet-4-6';
+    rl.close();
+    const config = {
+        agents: [
+            {
+                id: agentId,
+                name: agentName,
+                emoji: '',
+                workspace,
+                model,
+                skills: [],
+                allowedTools: [...DEFAULT_ALLOWED_TOOLS],
+                maxConcurrentSessions: 4,
+            },
+        ],
+        bindings: [],
+        plugins: [],
+        heartbeats: [],
+    };
+    await ensureDirectories();
+    await saveConfig(config);
+    console.log(`\nccgateway initialized at: ${process.env.CCG_HOME || join(homedir(), '.ccgateway')}`);
+    console.log(`Agent "${agentId}" created with workspace: ${workspace}`);
+    console.log('\nNext steps:');
+    console.log('  ccg agents list     — see your agents');
+    console.log('  ccg chat <agent>    — start a chat');
+    console.log('  ccg start           — start the daemon');
+}
+//# sourceMappingURL=migrate.js.map

package/dist/migrate.js.map

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

package/dist/plugin.d.ts

@@ -0,0 +1,63 @@
+import type { CcgConfig, AgentConfig, IncomingMessage } from "./types.js";
+export interface AgentRegistry {
+    getAgent(id: string): AgentConfig | undefined;
+    listAgents(): AgentConfig[];
+}
+export interface SessionManager {
+    getOrCreateSession(agentId: string, source: string, sourceId: string): string;
+    resetSession(agentId: string, sessionKey: string): Promise<void>;
+}
+export interface MessageRouter {
+    route(message: IncomingMessage): Promise<string>;
+    resolveAgent(gateway: string, channelId: string): string | undefined;
+}
+export interface CcgCore {
+    config: CcgConfig;
+    agents: AgentRegistry;
+    sessions: SessionManager;
+    router: MessageRouter;
+    send(agentId: string, message: string, fromAgent?: string): Promise<void>;
+}
+export type PluginType = "gateway" | "skill" | "tool";
+export interface CcgPlugin {
+    name: string;
+    type: PluginType;
+    init(core: CcgCore): Promise<void>;
+    start?(): Promise<void>;
+    stop?(): Promise<void>;
+}
+/** A module's default export must be a factory that returns a CcgPlugin. */
+export type PluginFactory = () => CcgPlugin;
+export declare class PluginLoader {
+    private plugins;
+    /**
+     * Loads all enabled plugins listed in `config.plugins`.
+     *
+     * For each entry the loader tries, in order:
+     *   1. `import(name)` — works for packages in node_modules
+     *   2. `import($CCG_HOME/plugins/<name>/index.js)`
+     *
+     * The module's default export must be a `PluginFactory` (a function
+     * returning a `CcgPlugin`).
+     */
+    loadPlugins(config: CcgConfig, core: CcgCore): Promise<void>;
+    /** Start all loaded plugins (in load order). */
+    startAll(): Promise<void>;
+    /** Stop all loaded plugins (reverse of load order). */
+    stopAll(): Promise<void>;
+    /** Register a plugin that was created externally (e.g., built-in plugins). */
+    registerPlugin(plugin: CcgPlugin): void;
+    /** Returns all loaded plugins. */
+    getPlugins(): CcgPlugin[];
+    /** Returns loaded plugins filtered by type. */
+    getPluginsByType(type: PluginType): CcgPlugin[];
+    /** Returns a specific plugin by name, or undefined. */
+    getPlugin(name: string): CcgPlugin | undefined;
+    /**
+     * Attempt to import a plugin module.
+     * Tries the bare name first (node_modules), then falls back to
+     * `$CCG_HOME/plugins/<name>/index.js`.
+     */
+    private importPlugin;
+}
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,SAAS,EACT,WAAW,EACX,eAAe,EAChB,MAAM,YAAY,CAAC;AAMpB,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;IAC9C,UAAU,IAAI,WAAW,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,kBAAkB,CAChB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,MAAM,CAAC;IACV,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClE;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACjD,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACtE;AAID,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,aAAa,CAAC;IACtB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3E;AAID,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAEtD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,4EAA4E;AAC5E,MAAM,MAAM,aAAa,GAAG,MAAM,SAAS,CAAC;AAI5C,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAmB;IAElC;;;;;;;;;OASG;IACG,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAkClE,gDAAgD;IAC1C,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAS/B,uDAAuD;IACjD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAU9B,8EAA8E;IAC9E,cAAc,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAIvC,kCAAkC;IAClC,UAAU,IAAI,SAAS,EAAE;IAIzB,+CAA+C;IAC/C,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,EAAE;IAI/C,uDAAuD;IACvD,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAM9C;;;;OAIG;YACW,YAAY;CAW3B"}

package/dist/plugin.js

@@ -0,0 +1,93 @@
+import { join } from "node:path";
+import { getCcgHome } from "./config.js";
+import { logger } from "./logger.js";
+// ── Plugin loader ──────────────────────────────────────────────────────────
+export class PluginLoader {
+    plugins = [];
+    /**
+     * Loads all enabled plugins listed in `config.plugins`.
+     *
+     * For each entry the loader tries, in order:
+     *   1. `import(name)` — works for packages in node_modules
+     *   2. `import($CCG_HOME/plugins/<name>/index.js)`
+     *
+     * The module's default export must be a `PluginFactory` (a function
+     * returning a `CcgPlugin`).
+     */
+    async loadPlugins(config, core) {
+        for (const entry of config.plugins) {
+            if (!entry.enabled) {
+                logger.debug(`plugin: skipping disabled plugin "${entry.name}"`);
+                continue;
+            }
+            let mod;
+            try {
+                mod = await this.importPlugin(entry.name);
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                logger.error(`plugin: failed to import "${entry.name}": ${message}`);
+                throw new Error(`Failed to load plugin "${entry.name}": ${message}`);
+            }
+            if (typeof mod.default !== "function") {
+                throw new Error(`Plugin "${entry.name}" does not default-export a factory function`);
+            }
+            const plugin = mod.default();
+            await plugin.init(core);
+            this.plugins.push(plugin);
+            logger.info(`plugin: loaded "${plugin.name}" (type=${plugin.type})`);
+        }
+    }
+    /** Start all loaded plugins (in load order). */
+    async startAll() {
+        for (const plugin of this.plugins) {
+            if (plugin.start) {
+                await plugin.start();
+                logger.info(`plugin: started "${plugin.name}"`);
+            }
+        }
+    }
+    /** Stop all loaded plugins (reverse of load order). */
+    async stopAll() {
+        for (let i = this.plugins.length - 1; i >= 0; i--) {
+            const plugin = this.plugins[i];
+            if (plugin.stop) {
+                await plugin.stop();
+                logger.info(`plugin: stopped "${plugin.name}"`);
+            }
+        }
+    }
+    /** Register a plugin that was created externally (e.g., built-in plugins). */
+    registerPlugin(plugin) {
+        this.plugins.push(plugin);
+    }
+    /** Returns all loaded plugins. */
+    getPlugins() {
+        return [...this.plugins];
+    }
+    /** Returns loaded plugins filtered by type. */
+    getPluginsByType(type) {
+        return this.plugins.filter((p) => p.type === type);
+    }
+    /** Returns a specific plugin by name, or undefined. */
+    getPlugin(name) {
+        return this.plugins.find((p) => p.name === name);
+    }
+    // ── Private helpers ────────────────────────────────────────────────────
+    /**
+     * Attempt to import a plugin module.
+     * Tries the bare name first (node_modules), then falls back to
+     * `$CCG_HOME/plugins/<name>/index.js`.
+     */
+    async importPlugin(name) {
+        try {
+            return await import(name);
+        }
+        catch {
+            // Fall back to the local plugins directory
+            const localPath = join(getCcgHome(), "plugins", name, "index.js");
+            return await import(localPath);
+        }
+    }
+}
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

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

package/dist/plugins/discord-gateway.d.ts

@@ -0,0 +1,32 @@
+import { type Message } from "discord.js";
+import type { CcgPlugin } from "../plugin.js";
+import type { IncomingMessage } from "../types.js";
+interface DiscordBotConfig {
+    token: string;
+}
+interface DiscordGatewayConfig {
+    bots: Record<string, DiscordBotConfig>;
+    guild: string;
+    allowedUsers: string[];
+    commands: string[];
+}
+/**
+ * Resolve a token value. If it starts with "$", treat it as an env var name.
+ * Throws if the env var is not set.
+ */
+export declare function resolveToken(token: string): string;
+/**
+ * Smart message splitter for Discord's 2000-char limit.
+ * Prefers splitting at paragraph boundaries (\n\n), then line boundaries (\n),
+ * then hard-cuts at the limit.
+ *
+ * Preserves code block fences across splits.
+ */
+export declare function splitMessage(text: string, limit?: number): string[];
+/**
+ * Normalize a Discord message into an IncomingMessage.
+ */
+export declare function normalizeMessage(msg: Message, agentId: string): IncomingMessage;
+export default function createDiscordGateway(pluginConfig: DiscordGatewayConfig): CcgPlugin;
+export {};
+//# sourceMappingURL=discord-gateway.d.ts.map

package/dist/plugins/discord-gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discord-gateway.d.ts","sourceRoot":"","sources":["../../src/plugins/discord-gateway.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,OAAO,EAAoB,MAAM,YAAY,CAAC;AACvF,OAAO,KAAK,EAAE,SAAS,EAAW,MAAM,cAAc,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAKnD,UAAU,gBAAgB;IACxB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,UAAU,oBAAoB;IAC5B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAID;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAYlD;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,MAAa,GAAG,MAAM,EAAE,CAoCzE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,OAAO,EACZ,OAAO,EAAE,MAAM,GACd,eAAe,CAiBjB;AAID,MAAM,CAAC,OAAO,UAAU,oBAAoB,CAC1C,YAAY,EAAE,oBAAoB,GACjC,SAAS,CAyLX"}