@hybridaione/hybridclaw 0.2.2 → 0.2.6

package/dist/channels/discord/presence.js

@@ -0,0 +1,111 @@
+import { ActivityType } from 'discord.js';
+import { logger } from '../../logger.js';
+function toDiscordActivityType(type) {
+    switch (type) {
+        case 'playing':
+            return ActivityType.Playing;
+        case 'listening':
+            return ActivityType.Listening;
+        case 'competing':
+            return ActivityType.Competing;
+        case 'custom':
+            return ActivityType.Custom;
+        case 'watching':
+        default:
+            return ActivityType.Watching;
+    }
+}
+function presenceTextForState(config, state) {
+    if (state === 'degraded')
+        return config.degradedText;
+    if (state === 'exhausted')
+        return config.exhaustedText;
+    return config.healthyText;
+}
+function presenceStatusForState(state) {
+    if (state === 'maintenance')
+        return 'invisible';
+    if (state === 'exhausted')
+        return 'dnd';
+    if (state === 'degraded')
+        return 'idle';
+    return 'online';
+}
+export class DiscordAutoPresenceController {
+    client;
+    getConfig;
+    resolveState;
+    timer = null;
+    running = false;
+    maintenance = false;
+    lastFingerprint = '';
+    constructor(params) {
+        this.client = params.client;
+        this.getConfig = params.getConfig;
+        this.resolveState = params.resolveState;
+    }
+    start() {
+        this.stop();
+        this.running = true;
+        const tick = async () => {
+            if (!this.running)
+                return;
+            await this.evaluateNow();
+            if (!this.running)
+                return;
+            const intervalMs = Math.max(5_000, Math.floor(this.getConfig().intervalMs));
+            this.timer = setTimeout(() => {
+                void tick();
+            }, intervalMs);
+        };
+        this.timer = setTimeout(() => {
+            void tick();
+        }, 0);
+    }
+    stop() {
+        this.running = false;
+        if (!this.timer)
+            return;
+        clearTimeout(this.timer);
+        this.timer = null;
+    }
+    async setMaintenance() {
+        this.maintenance = true;
+        await this.evaluateNow();
+    }
+    async evaluateNow() {
+        const config = this.getConfig();
+        if (!this.client.user)
+            return;
+        if (!config.enabled && !this.maintenance)
+            return;
+        const state = this.maintenance ? 'maintenance' : this.resolveState();
+        const status = presenceStatusForState(state);
+        const activityText = state === 'maintenance' ? '' : presenceTextForState(config, state);
+        const activityType = toDiscordActivityType(config.activityType);
+        const fingerprint = `${state}:${status}:${activityType}:${activityText}`;
+        if (fingerprint === this.lastFingerprint)
+            return;
+        try {
+            if (state === 'maintenance') {
+                await this.client.user.setPresence({
+                    status,
+                    activities: [],
+                });
+            }
+            else {
+                await this.client.user.setPresence({
+                    status,
+                    activities: activityText
+                        ? [{ name: activityText, type: activityType }]
+                        : [],
+                });
+            }
+            this.lastFingerprint = fingerprint;
+        }
+        catch (error) {
+            logger.debug({ error, state }, 'Failed to update Discord presence');
+        }
+    }
+}
+//# sourceMappingURL=presence.js.map

package/dist/channels/discord/presence.js.map

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

package/dist/channels/discord/rate-limiter.d.ts

@@ -0,0 +1,14 @@
+export interface RateLimitDecision {
+    allowed: boolean;
+    remaining: number;
+    retryAfterMs: number;
+}
+export declare class SlidingWindowRateLimiter {
+    private readonly windowMs;
+    private readonly buckets;
+    private readonly notifyAt;
+    constructor(windowMs?: number);
+    check(key: string, limit: number, nowMs?: number): RateLimitDecision;
+    shouldNotify(key: string, cooldownMs?: number, nowMs?: number): boolean;
+}
+//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/channels/discord/rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../../src/channels/discord/rate-limiter.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,wBAAwB;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+B;IACvD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;gBAE1C,QAAQ,SAAS;IAI7B,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,SAAa,GAAG,iBAAiB;IAkCxE,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,SAAS,EAAE,KAAK,SAAa,GAAG,OAAO;CAQ5E"}

package/dist/channels/discord/rate-limiter.js

@@ -0,0 +1,49 @@
+export class SlidingWindowRateLimiter {
+    windowMs;
+    buckets = new Map();
+    notifyAt = new Map();
+    constructor(windowMs = 60_000) {
+        this.windowMs = Math.max(1_000, Math.floor(windowMs));
+    }
+    check(key, limit, nowMs = Date.now()) {
+        const boundedLimit = Math.max(0, Math.floor(limit));
+        if (!key || boundedLimit === 0) {
+            return {
+                allowed: true,
+                remaining: Number.POSITIVE_INFINITY,
+                retryAfterMs: 0,
+            };
+        }
+        const cutoff = nowMs - this.windowMs;
+        const timestamps = this.buckets.get(key) ?? [];
+        const active = timestamps.filter((ts) => ts > cutoff);
+        if (active.length >= boundedLimit) {
+            this.buckets.set(key, active);
+            const oldest = active[0];
+            const retryAfterMs = Math.max(0, oldest + this.windowMs - nowMs);
+            return {
+                allowed: false,
+                remaining: 0,
+                retryAfterMs,
+            };
+        }
+        active.push(nowMs);
+        this.buckets.set(key, active);
+        return {
+            allowed: true,
+            remaining: Math.max(0, boundedLimit - active.length),
+            retryAfterMs: 0,
+        };
+    }
+    shouldNotify(key, cooldownMs = 10_000, nowMs = Date.now()) {
+        if (!key)
+            return true;
+        const boundedCooldown = Math.max(1_000, Math.floor(cooldownMs));
+        const nextAllowedAt = this.notifyAt.get(key) ?? 0;
+        if (nowMs < nextAllowedAt)
+            return false;
+        this.notifyAt.set(key, nowMs + boundedCooldown);
+        return true;
+    }
+}
+//# sourceMappingURL=rate-limiter.js.map

package/dist/channels/discord/rate-limiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.js","sourceRoot":"","sources":["../../../src/channels/discord/rate-limiter.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,wBAAwB;IAClB,QAAQ,CAAS;IACjB,OAAO,GAAG,IAAI,GAAG,EAAoB,CAAC;IACtC,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEtD,YAAY,QAAQ,GAAG,MAAM;QAC3B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,GAAW,EAAE,KAAa,EAAE,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE;QAClD,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QACpD,IAAI,CAAC,GAAG,IAAI,YAAY,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,SAAS,EAAE,MAAM,CAAC,iBAAiB;gBACnC,YAAY,EAAE,CAAC;aAChB,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC;QACrC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QAC/C,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC;QAEtD,IAAI,MAAM,CAAC,MAAM,IAAI,YAAY,EAAE,CAAC;YAClC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YAC9B,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;YACzB,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,CAAC;YACjE,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,SAAS,EAAE,CAAC;gBACZ,YAAY;aACb,CAAC;QACJ,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC9B,OAAO;YACL,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC;YACpD,YAAY,EAAE,CAAC;SAChB,CAAC;IACJ,CAAC;IAED,YAAY,CAAC,GAAW,EAAE,UAAU,GAAG,MAAM,EAAE,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE;QAC/D,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QACtB,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;QAChE,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClD,IAAI,KAAK,GAAG,aAAa;YAAE,OAAO,KAAK,CAAC;QACxC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,GAAG,eAAe,CAAC,CAAC;QAChD,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/channels/discord/reactions.d.ts

@@ -0,0 +1,38 @@
+import type { Message as DiscordMessage } from 'discord.js';
+export type LifecyclePhase = 'queued' | 'thinking' | 'toolUse' | 'streaming' | 'done' | 'error';
+export type DiscordRetryFn = <T>(label: string, fn: () => Promise<T>) => Promise<T>;
+export declare function addAckReaction(params: {
+    message: DiscordMessage;
+    emoji: string;
+    withRetry: DiscordRetryFn;
+    botUserId: string;
+}): Promise<() => Promise<void>>;
+interface LifecycleReactionConfig {
+    enabled: boolean;
+    removeOnComplete: boolean;
+    phases: Record<LifecyclePhase, string>;
+}
+export declare class LifecycleReactionController {
+    private readonly message;
+    private readonly withRetry;
+    private readonly botUserId;
+    private readonly config;
+    private currentEmoji;
+    private currentPhase;
+    private queue;
+    private lastReactionAt;
+    constructor(params: {
+        message: DiscordMessage;
+        withRetry: DiscordRetryFn;
+        botUserId: string;
+        config: LifecycleReactionConfig;
+    });
+    setPhase(phase: LifecyclePhase): void;
+    clear(): Promise<void>;
+    private transitionToPhase;
+    private waitForReactionWindow;
+    private addReaction;
+    private removeReaction;
+}
+export {};
+//# sourceMappingURL=reactions.d.ts.map

package/dist/channels/discord/reactions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactions.d.ts","sourceRoot":"","sources":["../../../src/channels/discord/reactions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,YAAY,CAAC;AAI5D,MAAM,MAAM,cAAc,GACtB,QAAQ,GACR,UAAU,GACV,SAAS,GACT,WAAW,GACX,MAAM,GACN,OAAO,CAAC;AACZ,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,EAC7B,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KACjB,OAAO,CAAC,CAAC,CAAC,CAAC;AAwBhB,wBAAsB,cAAc,CAAC,MAAM,EAAE;IAC3C,OAAO,EAAE,cAAc,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,cAAc,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CA0C/B;AAED,UAAU,uBAAuB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;CACxC;AAED,qBAAa,2BAA2B;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IACjD,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,cAAc,CAAK;gBAEf,MAAM,EAAE;QAClB,OAAO,EAAE,cAAc,CAAC;QACxB,SAAS,EAAE,cAAc,CAAC;QAC1B,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,uBAAuB,CAAC;KACjC;IAOD,QAAQ,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAqB/B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YASd,iBAAiB;YAkBjB,qBAAqB;YAMrB,WAAW;YAoBX,cAAc;CAqB7B"}

package/dist/channels/discord/reactions.js

@@ -0,0 +1,151 @@
+import { logger } from '../../logger.js';
+const MIN_REACTION_GAP_MS = 350;
+const DONE_REACTION_VISIBILITY_MS = 1_000;
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function findReactionByEmoji(message, emoji) {
+    const direct = message.reactions.resolve(emoji);
+    if (direct)
+        return direct;
+    const trimmed = emoji.trim();
+    if (!trimmed)
+        return null;
+    const fallback = message.reactions.cache.find((reaction) => reaction.emoji.toString() === trimmed || reaction.emoji.name === trimmed);
+    return fallback ?? null;
+}
+export async function addAckReaction(params) {
+    const reactionEmoji = params.emoji.trim();
+    if (!reactionEmoji) {
+        return async () => { };
+    }
+    try {
+        await params.withRetry('reaction-ack-add', () => params.message.react(reactionEmoji));
+    }
+    catch (error) {
+        logger.debug({
+            error,
+            channelId: params.message.channelId,
+            messageId: params.message.id,
+            reactionEmoji,
+        }, 'Failed to add ack reaction');
+        return async () => { };
+    }
+    return async () => {
+        try {
+            const reaction = findReactionByEmoji(params.message, reactionEmoji);
+            if (!reaction)
+                return;
+            await params.withRetry('reaction-ack-remove', () => reaction.users.remove(params.botUserId));
+        }
+        catch (error) {
+            logger.debug({
+                error,
+                channelId: params.message.channelId,
+                messageId: params.message.id,
+                reactionEmoji,
+            }, 'Failed to remove ack reaction');
+        }
+    };
+}
+export class LifecycleReactionController {
+    message;
+    withRetry;
+    botUserId;
+    config;
+    currentEmoji = null;
+    currentPhase = null;
+    queue = Promise.resolve();
+    lastReactionAt = 0;
+    constructor(params) {
+        this.message = params.message;
+        this.withRetry = params.withRetry;
+        this.botUserId = params.botUserId;
+        this.config = params.config;
+    }
+    setPhase(phase) {
+        if (!this.config.enabled)
+            return;
+        if (this.currentPhase === phase)
+            return;
+        this.currentPhase = phase;
+        this.queue = this.queue
+            .then(async () => {
+            await this.transitionToPhase(phase);
+        })
+            .catch((error) => {
+            logger.debug({
+                error,
+                channelId: this.message.channelId,
+                messageId: this.message.id,
+                phase,
+            }, 'Lifecycle reaction transition failed');
+        });
+    }
+    async clear() {
+        if (!this.config.enabled)
+            return;
+        await this.queue;
+        if (!this.currentEmoji)
+            return;
+        await this.removeReaction(this.currentEmoji);
+        this.currentEmoji = null;
+        this.currentPhase = null;
+    }
+    async transitionToPhase(phase) {
+        const nextEmoji = (this.config.phases[phase] || '').trim();
+        if (!nextEmoji)
+            return;
+        if (this.currentEmoji && this.currentEmoji !== nextEmoji) {
+            await this.removeReaction(this.currentEmoji);
+            this.currentEmoji = null;
+        }
+        await this.addReaction(nextEmoji);
+        this.currentEmoji = nextEmoji;
+        if (phase === 'done' && this.config.removeOnComplete) {
+            await sleep(DONE_REACTION_VISIBILITY_MS);
+            await this.removeReaction(nextEmoji);
+            this.currentEmoji = null;
+        }
+    }
+    async waitForReactionWindow() {
+        const elapsed = Date.now() - this.lastReactionAt;
+        if (elapsed >= MIN_REACTION_GAP_MS)
+            return;
+        await sleep(MIN_REACTION_GAP_MS - elapsed);
+    }
+    async addReaction(emoji) {
+        await this.waitForReactionWindow();
+        try {
+            await this.withRetry('reaction-lifecycle-add', () => this.message.react(emoji));
+            this.lastReactionAt = Date.now();
+        }
+        catch (error) {
+            logger.debug({
+                error,
+                channelId: this.message.channelId,
+                messageId: this.message.id,
+                emoji,
+            }, 'Failed to add lifecycle reaction');
+        }
+    }
+    async removeReaction(emoji) {
+        await this.waitForReactionWindow();
+        try {
+            const reaction = findReactionByEmoji(this.message, emoji);
+            if (!reaction)
+                return;
+            await this.withRetry('reaction-lifecycle-remove', () => reaction.users.remove(this.botUserId));
+            this.lastReactionAt = Date.now();
+        }
+        catch (error) {
+            logger.debug({
+                error,
+                channelId: this.message.channelId,
+                messageId: this.message.id,
+                emoji,
+            }, 'Failed to remove lifecycle reaction');
+        }
+    }
+}
+//# sourceMappingURL=reactions.js.map

package/dist/channels/discord/reactions.js.map

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

package/dist/channels/discord/runtime.d.ts

@@ -1,8 +1,9 @@
-import { AttachmentBuilder, Client, type Message as DiscordMessage } from 'discord.js';
+import { type AttachmentBuilder, Client, type Message as DiscordMessage } from 'discord.js';
+import type { MediaContextItem } from '../../types.js';
 import { type MentionLookup } from './mentions.js';
-import { type DiscordToolActionRequest } from './tool-actions.js';
+import { type LifecyclePhase } from './reactions.js';
 import { DiscordStreamManager } from './stream.js';
-import type { MediaContextItem } from '../../types.js';
+import { type DiscordToolActionRequest } from './tool-actions.js';
 export type ReplyFn = (content: string, files?: AttachmentBuilder[]) => Promise<void>;
 export interface MessageRunContext {
     sourceMessage: DiscordMessage;
@@ -10,11 +11,13 @@ export interface MessageRunContext {
     abortSignal: AbortSignal;
     stream: DiscordStreamManager;
     mentionLookup: MentionLookup;
+    emitLifecyclePhase: (phase: LifecyclePhase) => void;
 }
 export type MessageHandler = (sessionId: string, guildId: string | null, channelId: string, userId: string, username: string, content: string, media: MediaContextItem[], reply: ReplyFn, context: MessageRunContext) => Promise<void>;
 export type CommandHandler = (sessionId: string, guildId: string | null, channelId: string, args: string[], reply: ReplyFn) => Promise<void>;
 export declare function runDiscordToolAction(request: DiscordToolActionRequest): Promise<Record<string, unknown>>;
 export declare function initDiscord(onMessage: MessageHandler, onCommand: CommandHandler): Client;
+export declare function setDiscordMaintenancePresence(): Promise<void>;
 /**
  * Send a message to a channel by ID (used by scheduler).
  */

package/dist/channels/discord/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/channels/discord/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,iBAAiB,EACjB,MAAM,EAEN,KAAK,OAAO,IAAI,cAAc,EAE/B,MAAM,YAAY,CAAC;AAoBpB,OAAO,EAIL,KAAK,aAAa,EACnB,MAAM,eAAe,CAAC;AAQvB,OAAO,EAGL,KAAK,wBAAwB,EAC9B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,iBAAiB,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAiBtF,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,cAAc,CAAC;IAC9B,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,WAAW,EAAE,WAAW,CAAC;IACzB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,aAAa,EAAE,aAAa,CAAC;CAC9B;AAED,MAAM,MAAM,cAAc,GAAG,CAC3B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,gBAAgB,EAAE,EACzB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,iBAAiB,KACvB,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB,MAAM,MAAM,cAAc,GAAG,CAC3B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EAAE,EACd,KAAK,EAAE,OAAO,KACX,OAAO,CAAC,IAAI,CAAC,CAAC;AA+TnB,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAElC;AAoRD,wBAAgB,WAAW,CAAC,SAAS,EAAE,cAAc,EAAE,SAAS,EAAE,cAAc,GAAG,MAAM,CAmexF;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAW/G"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/channels/discord/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,iBAAiB,EACtB,MAAM,EACN,KAAK,OAAO,IAAI,cAAc,EAG/B,MAAM,YAAY,CAAC;AA2BpB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAwBvD,OAAO,EAGL,KAAK,aAAa,EAEnB,MAAM,eAAe,CAAC;AAMvB,OAAO,EAEL,KAAK,cAAc,EAEpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAGL,KAAK,wBAAwB,EAC9B,MAAM,mBAAmB,CAAC;AAG3B,MAAM,MAAM,OAAO,GAAG,CACpB,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,iBAAiB,EAAE,KACxB,OAAO,CAAC,IAAI,CAAC,CAAC;AAiBnB,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,cAAc,CAAC;IAC9B,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,WAAW,EAAE,WAAW,CAAC;IACzB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,aAAa,EAAE,aAAa,CAAC;IAC7B,kBAAkB,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;CACrD;AAED,MAAM,MAAM,cAAc,GAAG,CAC3B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,gBAAgB,EAAE,EACzB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,iBAAiB,KACvB,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB,MAAM,MAAM,cAAc,GAAG,CAC3B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EAAE,EACd,KAAK,EAAE,OAAO,KACX,OAAO,CAAC,IAAI,CAAC,CAAC;AAoYnB,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAElC;AAsiBD,wBAAgB,WAAW,CACzB,SAAS,EAAE,cAAc,EACzB,SAAS,EAAE,cAAc,GACxB,MAAM,CAu7BR;AAED,wBAAsB,6BAA6B,IAAI,OAAO,CAAC,IAAI,CAAC,CAGnE;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,iBAAiB,EAAE,GAC1B,OAAO,CAAC,IAAI,CAAC,CAgBf"}