@waifucave/discord-waifus 1.5.154

package/dist/discord/client.d.ts

@@ -0,0 +1,394 @@
+import { ApplicationCommandOptionType } from "discord.js";
+import { Logger } from "../backend/logger.js";
+import { ContextMessage } from "../orchestration/context.js";
+import { DiscordBotConfig, GuildEmojiCacheEntry, GuildMemberCacheEntry, GuildRoleCacheEntry } from "../shared/schemas/domain.js";
+export type DiscordRuntimeStatus = {
+    connected: boolean;
+    orchestratorConnected: boolean;
+    waifuBotCount: number;
+    warnings: string[];
+    connecting?: boolean;
+    retrying?: boolean;
+    retryAttempt?: number;
+    nextRetryAt?: string;
+    lastError?: string;
+    lastErrorAt?: string;
+};
+export type DiscordRuntimeIssue = {
+    source: "client-error" | "shard-error" | "shard-disconnect" | "invalidated" | "warn";
+    message: string;
+    botId?: string;
+    shardId?: number;
+    code?: string | number;
+    wasClean?: boolean;
+    error?: unknown;
+};
+export interface DiscordGatewayFacade {
+    connect(): Promise<DiscordRuntimeStatus>;
+    disconnect(): Promise<void>;
+    onMessage?(listener: DiscordMessageListener): () => void;
+    onReviewCommand?(listener: DiscordReviewCommandListener): () => void;
+    onClearCommand?(listener: DiscordClearCommandListener): () => void;
+    onRunCommand?(listener: DiscordRunCommandListener): () => void;
+    onRunWaifuAutocomplete?(listener: DiscordRunWaifuAutocompleteListener): () => void;
+    onStopCommand?(listener: DiscordStopCommandListener): () => void;
+    onMemoriesCommand?(listener: DiscordMemoriesCommandListener): () => void;
+    onPrintCommand?(listener: DiscordPrintCommandListener): () => void;
+    onPrintWaifuAutocomplete?(listener: DiscordPrintWaifuAutocompleteListener): () => void;
+    onDebugCommand?(listener: DiscordDebugCommandListener): () => void;
+    listGuilds?(): Promise<Array<{
+        guildId: string;
+        name: string;
+    }>>;
+    fetchChannelMetadata?(input: {
+        guildId: string;
+        channelId: string;
+    }): Promise<DiscordChannelMetadata>;
+    fetchFreshContext(input: {
+        guildId: string;
+        channelId: string;
+        limit: number;
+        signal?: AbortSignal;
+    }): Promise<ContextMessage[]>;
+    sendWaifuMessage(input: {
+        guildId: string;
+        channelId: string;
+        content: string;
+        senderBotId?: string;
+        replyToMessageId?: string;
+        allowedUserMentionIds: string[];
+    }): Promise<{
+        messageId: string;
+    }>;
+    sendTyping(input: {
+        guildId: string;
+        channelId: string;
+        senderBotId?: string;
+    }): Promise<void>;
+    validateDebugChannel?(input: {
+        channelId: string;
+        requireMessages?: boolean;
+        requireSend?: boolean;
+    }): Promise<DiscordDebugChannelInfo>;
+    sendDebugMessage?(input: {
+        channelId: string;
+        content: string;
+    }): Promise<{
+        messageId: string;
+    }>;
+    deleteMessages?(input: {
+        guildId: string;
+        channelId: string;
+        messageIds: string[];
+        authorId?: string;
+        authorIdByMessageId?: Record<string, string>;
+    }): Promise<DiscordDeleteMessagesResult>;
+    deleteAllMessages?(input: {
+        guildId: string;
+        channelId: string;
+    }): Promise<DiscordDeleteChannelMessagesResult>;
+}
+export type DiscordMessageEvent = {
+    guildId: string;
+    channelId: string;
+    messageId: string;
+    authorId: string;
+    authorDisplayName?: string;
+    authorBot: boolean;
+};
+export type DiscordMessageListener = (event: DiscordMessageEvent) => void | Promise<void>;
+export type DiscordSlashCommandEvent = {
+    guildId: string;
+    channelId: string;
+    userId: string;
+    commandMessageId?: string;
+    respond: (content: string) => Promise<void>;
+};
+export type DiscordReviewCommandEvent = DiscordSlashCommandEvent;
+export type DiscordClearCommandEvent = DiscordSlashCommandEvent & {
+    count?: number;
+    type?: DiscordClearType;
+};
+export type DiscordRunCommandEvent = DiscordSlashCommandEvent & {
+    waifuId?: string;
+    sceneDirection?: string;
+};
+export type DiscordAutocompleteChoice = {
+    name: string;
+    value: string;
+};
+export type DiscordRunWaifuAutocompleteEvent = {
+    guildId?: string;
+    channelId?: string;
+    focusedValue: string;
+    respond: (choices: DiscordAutocompleteChoice[]) => Promise<void>;
+};
+export type DiscordStopCommandEvent = DiscordSlashCommandEvent;
+export type DiscordMemoriesCommandEvent = DiscordSlashCommandEvent;
+export type DiscordPrintCommandEvent = DiscordSlashCommandEvent & {
+    type?: DiscordPrintCommandType;
+    waifuId?: string;
+};
+export type DiscordPrintWaifuAutocompleteEvent = {
+    guildId?: string;
+    channelId?: string;
+    focusedValue: string;
+    respond: (choices: DiscordAutocompleteChoice[]) => Promise<void>;
+};
+export type DiscordDebugCommandEvent = DiscordSlashCommandEvent & {
+    type?: DiscordDebugCommandType;
+    sourceChannelId?: string;
+};
+export type DiscordReviewCommandListener = (event: DiscordReviewCommandEvent) => void | Promise<void>;
+export type DiscordClearCommandListener = (event: DiscordClearCommandEvent) => void | Promise<void>;
+export type DiscordRunCommandListener = (event: DiscordRunCommandEvent) => void | Promise<void>;
+export type DiscordRunWaifuAutocompleteListener = (event: DiscordRunWaifuAutocompleteEvent) => void | Promise<void>;
+export type DiscordStopCommandListener = (event: DiscordStopCommandEvent) => void | Promise<void>;
+export type DiscordMemoriesCommandListener = (event: DiscordMemoriesCommandEvent) => void | Promise<void>;
+export type DiscordPrintCommandListener = (event: DiscordPrintCommandEvent) => void | Promise<void>;
+export type DiscordPrintWaifuAutocompleteListener = (event: DiscordPrintWaifuAutocompleteEvent) => void | Promise<void>;
+export type DiscordDebugCommandListener = (event: DiscordDebugCommandEvent) => void | Promise<void>;
+export type DiscordClearType = "waifus" | "users" | "both" | "everything";
+export type DiscordDebugCommandType = "set" | "unset" | "print";
+export type DiscordPrintCommandType = "system_prompt" | "memories" | "personality";
+export type DiscordDeleteMessagesResult = {
+    deletedMessageIds: string[];
+    failedMessageIds: Array<{
+        messageId: string;
+        message: string;
+    }>;
+};
+export type DiscordDeleteChannelMessagesResult = {
+    scannedMessageCount: number;
+    deletedCount: number;
+    failedCount: number;
+    failedMessageIds: Array<{
+        messageId: string;
+        message: string;
+    }>;
+};
+export type DiscordDebugChannelInfo = {
+    channelId: string;
+    guildId?: string;
+    name?: string;
+};
+export type DiscordChannelMetadata = {
+    guildId: string;
+    guildName?: string;
+    channelId: string;
+    channelName?: string;
+};
+type DiscordCache = {
+    members?: GuildMemberCacheEntry[];
+    emojis?: GuildEmojiCacheEntry[];
+    roles?: GuildRoleCacheEntry[];
+};
+export type DiscordJsGatewayOptions = {
+    orchestrator: DiscordBotConfig;
+    waifus?: DiscordBotConfig[];
+    members?: GuildMemberCacheEntry[];
+    emojis?: GuildEmojiCacheEntry[];
+    cacheForGuild?: (guildId: string) => Promise<DiscordCache>;
+    refreshMembersForGuild?: (guildId: string) => Promise<DiscordCache>;
+    refreshRolesForGuild?: (guildId: string) => Promise<DiscordCache>;
+    onRuntimeIssue?: (issue: DiscordRuntimeIssue) => void | Promise<void>;
+    logger?: Logger;
+};
+export declare class DiscordJsGateway implements DiscordGatewayFacade {
+    private readonly options;
+    private readonly clients;
+    private readonly listeners;
+    private readonly reviewListeners;
+    private readonly clearListeners;
+    private readonly runListeners;
+    private readonly runWaifuAutocompleteListeners;
+    private readonly stopListeners;
+    private readonly memoriesListeners;
+    private readonly printListeners;
+    private readonly printWaifuAutocompleteListeners;
+    private readonly debugListeners;
+    private readonly recentMentionRefreshes;
+    constructor(options: DiscordJsGatewayOptions);
+    connect(): Promise<DiscordRuntimeStatus>;
+    disconnect(): Promise<void>;
+    onMessage(listener: DiscordMessageListener): () => void;
+    onReviewCommand(listener: DiscordReviewCommandListener): () => void;
+    onClearCommand(listener: DiscordClearCommandListener): () => void;
+    onRunCommand(listener: DiscordRunCommandListener): () => void;
+    onRunWaifuAutocomplete(listener: DiscordRunWaifuAutocompleteListener): () => void;
+    onStopCommand(listener: DiscordStopCommandListener): () => void;
+    onMemoriesCommand(listener: DiscordMemoriesCommandListener): () => void;
+    onPrintCommand(listener: DiscordPrintCommandListener): () => void;
+    onPrintWaifuAutocomplete(listener: DiscordPrintWaifuAutocompleteListener): () => void;
+    onDebugCommand(listener: DiscordDebugCommandListener): () => void;
+    listGuilds(): Promise<Array<{
+        guildId: string;
+        name: string;
+    }>>;
+    fetchChannelMetadata(input: {
+        guildId: string;
+        channelId: string;
+    }): Promise<DiscordChannelMetadata>;
+    fetchFreshContext(input: {
+        guildId: string;
+        channelId: string;
+        limit: number;
+        signal?: AbortSignal;
+    }): Promise<ContextMessage[]>;
+    sendWaifuMessage(input: {
+        guildId: string;
+        channelId: string;
+        content: string;
+        senderBotId?: string;
+        replyToMessageId?: string;
+        allowedUserMentionIds: string[];
+    }): Promise<{
+        messageId: string;
+    }>;
+    sendTyping(input: {
+        guildId: string;
+        channelId: string;
+        senderBotId?: string;
+    }): Promise<void>;
+    validateDebugChannel(input: {
+        channelId: string;
+        requireMessages?: boolean;
+        requireSend?: boolean;
+    }): Promise<DiscordDebugChannelInfo>;
+    sendDebugMessage(input: {
+        channelId: string;
+        content: string;
+    }): Promise<{
+        messageId: string;
+    }>;
+    deleteMessages(input: {
+        guildId: string;
+        channelId: string;
+        messageIds: string[];
+        authorId?: string;
+        authorIdByMessageId?: Record<string, string>;
+    }): Promise<DiscordDeleteMessagesResult>;
+    deleteAllMessages(input: {
+        guildId: string;
+        channelId: string;
+    }): Promise<DiscordDeleteChannelMessagesResult>;
+    private deleteFetchedMessages;
+    private cacheForGuild;
+    private orchestratorClient;
+    private clientForAuthor;
+    private botIdForClient;
+    private shouldRefreshMentions;
+    private attachClientRuntimeHandlers;
+    private reportRuntimeIssue;
+    private callListener;
+    private dispatchListener;
+    private runBackground;
+    private handleReviewInteraction;
+    private handleClearInteraction;
+    private handleRunInteraction;
+    private handleRunAutocompleteInteraction;
+    private handleStopInteraction;
+    private handleMemoriesInteraction;
+    private handlePrintInteraction;
+    private handlePrintAutocompleteInteraction;
+    private handleDebugInteraction;
+}
+export declare class DiscordGatewayNotConfigured implements DiscordGatewayFacade {
+    connect(): Promise<DiscordRuntimeStatus>;
+    disconnect(): Promise<void>;
+    fetchFreshContext(): Promise<ContextMessage[]>;
+    sendWaifuMessage(): Promise<{
+        messageId: string;
+    }>;
+    sendTyping(): Promise<void>;
+}
+export declare function buildOrchestratorCommandPayloads(): ({
+    name: string;
+    description: string;
+    defaultMemberPermissions: bigint;
+    options?: undefined;
+} | {
+    name: string;
+    description: string;
+    defaultMemberPermissions: bigint;
+    options: ({
+        type: ApplicationCommandOptionType.String;
+        name: string;
+        description: string;
+        required: boolean;
+        choices: {
+            name: string;
+            value: string;
+        }[];
+        min_value?: undefined;
+        max_value?: undefined;
+    } | {
+        type: ApplicationCommandOptionType.Integer;
+        name: string;
+        description: string;
+        required: boolean;
+        min_value: number;
+        max_value: number;
+        choices?: undefined;
+    })[];
+} | {
+    name: string;
+    description: string;
+    options: ({
+        type: ApplicationCommandOptionType.String;
+        name: string;
+        description: string;
+        required: boolean;
+        autocomplete: boolean;
+    } | {
+        type: ApplicationCommandOptionType.String;
+        name: string;
+        description: string;
+        required: boolean;
+        autocomplete?: undefined;
+    })[];
+    defaultMemberPermissions?: undefined;
+} | {
+    name: string;
+    description: string;
+    defaultMemberPermissions: bigint;
+    options: ({
+        type: ApplicationCommandOptionType.String;
+        name: string;
+        description: string;
+        required: boolean;
+        choices: {
+            name: string;
+            value: string;
+        }[];
+        autocomplete?: undefined;
+    } | {
+        type: ApplicationCommandOptionType.String;
+        name: string;
+        description: string;
+        required: boolean;
+        autocomplete: boolean;
+        choices?: undefined;
+    })[];
+} | {
+    name: string;
+    description: string;
+    defaultMemberPermissions: bigint;
+    options: ({
+        type: ApplicationCommandOptionType.String;
+        name: string;
+        description: string;
+        required: boolean;
+        choices: {
+            name: string;
+            value: string;
+        }[];
+    } | {
+        type: ApplicationCommandOptionType.String;
+        name: string;
+        description: string;
+        required: boolean;
+        choices?: undefined;
+    })[];
+})[];
+export {};