@overpod/mcp-telegram 1.25.0 → 1.26.0

package/dist/telegram-client.d.ts

@@ -4,6 +4,81 @@ import { Api } from "telegram/tl/index.js";
 export declare function describeAdminLogAction(action: Api.TypeChannelAdminLogEventAction): string;
 export declare function describeAdminLogDetails(action: Api.TypeChannelAdminLogEventAction, describeUser: (userId: bigInt.BigInteger) => string): string;
 export declare function reactionToEmoji(reaction: Api.TypeReaction): string | null;
+export type CompactStatsGraph = {
+    type: "async";
+    token: string;
+} | {
+    type: "error";
+    error: string;
+} | {
+    type: "data";
+    data: unknown;
+    zoomToken?: string;
+};
+export type StatsValue = {
+    current: number;
+    previous: number;
+};
+export type BroadcastStatsSummary = {
+    period: {
+        minDate: number;
+        maxDate: number;
+    };
+    followers: StatsValue;
+    viewsPerPost: StatsValue;
+    sharesPerPost: StatsValue;
+    reactionsPerPost: StatsValue;
+    viewsPerStory: StatsValue;
+    sharesPerStory: StatsValue;
+    reactionsPerStory: StatsValue;
+    enabledNotifications: {
+        part: number;
+        total: number;
+        percent: number;
+    };
+    recentPostsInteractions: Array<{
+        kind: "message";
+        msgId: number;
+        views: number;
+        forwards: number;
+        reactions: number;
+    } | {
+        kind: "story";
+        storyId: number;
+        views: number;
+        forwards: number;
+        reactions: number;
+    }>;
+    graphs?: Record<string, CompactStatsGraph>;
+};
+export type MegagroupStatsSummary = {
+    period: {
+        minDate: number;
+        maxDate: number;
+    };
+    members: StatsValue;
+    messages: StatsValue;
+    viewers: StatsValue;
+    posters: StatsValue;
+    topPosters: Array<{
+        userId: string;
+        messages: number;
+        avgChars: number;
+    }>;
+    topAdmins: Array<{
+        userId: string;
+        deleted: number;
+        kicked: number;
+        banned: number;
+    }>;
+    topInviters: Array<{
+        userId: string;
+        invitations: number;
+    }>;
+    graphs?: Record<string, CompactStatsGraph>;
+};
+export declare function summarizeMegagroupStats(stats: Api.stats.MegagroupStats, includeGraphs: boolean): MegagroupStatsSummary;
+export declare function summarizeBroadcastStats(stats: Api.stats.BroadcastStats, includeGraphs: boolean): BroadcastStatsSummary;
 export type ChatPermissions = {
     sendMessages?: boolean;
     sendMedia?: boolean;
@@ -17,6 +92,383 @@ export type ChatPermissions = {
     pinMessages?: boolean;
 };
 export declare function mergeBannedRights(current: Record<string, unknown> | undefined | null, permissions: ChatPermissions): Record<string, boolean>;
+export type MessageButtonDescriptor = {
+    row: number;
+    col: number;
+    type: string;
+    label: string;
+    data?: string;
+    url?: string;
+    switchQuery?: string;
+    samePeer?: boolean;
+    userId?: string;
+    buttonId?: number;
+    copyText?: string;
+    requiresPassword?: boolean;
+    quiz?: boolean;
+};
+export declare function describeKeyboardButton(button: Api.TypeKeyboardButton, row: number, col: number): MessageButtonDescriptor;
+export type CompactPeer = {
+    kind: "user";
+    id: string;
+} | {
+    kind: "chat";
+    id: string;
+} | {
+    kind: "channel";
+    id: string;
+};
+export type UpdatesMessageSummary = {
+    id: number;
+    peer: CompactPeer;
+    fromId?: CompactPeer;
+    date: number;
+    text: string;
+    isService: boolean;
+};
+export type UpdatesDifferenceSummary = {
+    state: {
+        pts: number;
+        qts: number;
+        date: number;
+        seq: number;
+        unreadCount?: number;
+    };
+    isFinal: boolean;
+    newMessages: UpdatesMessageSummary[];
+    deletedMessageIds: Array<{
+        peer?: CompactPeer;
+        messageIds: number[];
+    }>;
+    otherUpdates: Array<{
+        type: string;
+    }>;
+    fallback?: {
+        kind: "tooLong";
+        suggestedAction: string;
+    };
+};
+export type ChannelDifferenceSummary = {
+    channelId: string;
+    pts: number;
+    isFinal: boolean;
+    timeout?: number;
+    newMessages: UpdatesMessageSummary[];
+    otherUpdates: Array<{
+        type: string;
+    }>;
+    fallback?: {
+        kind: "tooLong";
+        suggestedAction: string;
+    };
+};
+export declare function peerToCompact(peer: Api.TypePeer | undefined): CompactPeer | undefined;
+export declare function summarizeUpdatesDifference(diff: Api.updates.TypeDifference, cursor: {
+    pts: number;
+    qts: number;
+    date: number;
+}): UpdatesDifferenceSummary;
+export declare function summarizeChannelDifference(diff: Api.updates.TypeChannelDifference, channelId: string, fallbackPts: number): ChannelDifferenceSummary;
+export type StoryItemSummary = {
+    id: number;
+    kind: "active" | "deleted" | "skipped";
+    date?: number;
+    expireDate?: number;
+    caption?: string;
+    mediaType?: string;
+    pinned?: boolean;
+    public?: boolean;
+    closeFriends?: boolean;
+    edited?: boolean;
+    noforwards?: boolean;
+    fromId?: CompactPeer;
+    viewsCount?: number;
+    reactionsCount?: number;
+};
+export type PeerStoriesSummary = {
+    peer: CompactPeer;
+    maxReadId?: number;
+    stories: StoryItemSummary[];
+};
+export type AllStoriesSummary = {
+    modified: boolean;
+    state: string;
+    hasMore?: boolean;
+    count?: number;
+    peerStories: PeerStoriesSummary[];
+    stealthMode?: {
+        activeUntilDate?: number;
+        cooldownUntilDate?: number;
+    };
+};
+export type StoriesByIdSummary = {
+    count: number;
+    stories: StoryItemSummary[];
+    pinnedToTop?: number[];
+};
+export type StoryViewSummary = {
+    kind: "user";
+    userId: string;
+    date: number;
+    reaction?: string | null;
+    blocked?: boolean;
+    blockedMyStoriesFrom?: boolean;
+} | {
+    kind: "publicForward";
+    messageId?: number;
+    peer?: CompactPeer;
+    blocked?: boolean;
+    blockedMyStoriesFrom?: boolean;
+} | {
+    kind: "publicRepost";
+    peer?: CompactPeer;
+    storyId?: number;
+    blocked?: boolean;
+    blockedMyStoriesFrom?: boolean;
+};
+export type StoryViewsListSummary = {
+    count: number;
+    viewsCount: number;
+    forwardsCount: number;
+    reactionsCount: number;
+    views: StoryViewSummary[];
+    nextOffset?: string;
+};
+export type MyBoostSummary = {
+    slot: number;
+    peer?: CompactPeer;
+    date: number;
+    expires: number;
+    cooldownUntilDate?: number;
+};
+export type MyBoostsSummary = {
+    count: number;
+    myBoosts: MyBoostSummary[];
+};
+export declare function summarizeMyBoost(boost: Api.TypeMyBoost): MyBoostSummary;
+export declare function summarizeMyBoosts(result: Api.premium.TypeMyBoosts): MyBoostsSummary;
+export type PrepaidGiveawaySummary = {
+    kind: "premium" | "stars";
+    id: string;
+    quantity: number;
+    date: number;
+    months?: number;
+    stars?: string;
+    boosts?: number;
+};
+export type BoostsStatusSummary = {
+    level: number;
+    boosts: number;
+    currentLevelBoosts: number;
+    nextLevelBoosts?: number;
+    giftBoosts?: number;
+    premiumAudience?: {
+        part: number;
+        total: number;
+    };
+    boostUrl: string;
+    myBoost?: boolean;
+    myBoostSlots?: number[];
+    prepaidGiveaways?: PrepaidGiveawaySummary[];
+};
+export declare function summarizePrepaidGiveaway(g: Api.TypePrepaidGiveaway): PrepaidGiveawaySummary;
+export declare function summarizeBoostsStatus(result: Api.premium.TypeBoostsStatus): BoostsStatusSummary;
+export type BoostSummary = {
+    id: string;
+    userId?: string;
+    date: number;
+    expires: number;
+    gift?: boolean;
+    giveaway?: boolean;
+    unclaimed?: boolean;
+    giveawayMsgId?: number;
+    usedGiftSlug?: string;
+    multiplier?: number;
+    stars?: string;
+};
+export type BoostsListSummary = {
+    count: number;
+    boosts: BoostSummary[];
+    nextOffset?: string;
+};
+export declare function summarizeBoost(boost: Api.TypeBoost): BoostSummary;
+export declare function summarizeBoostsList(result: Api.premium.TypeBoostsList): BoostsListSummary;
+export type BusinessChatLinkSummary = {
+    link: string;
+    message: string;
+    title?: string;
+    views: number;
+    entityCount: number;
+};
+export type BusinessChatLinksSummary = {
+    count: number;
+    links: BusinessChatLinkSummary[];
+};
+export declare function summarizeBusinessChatLink(link: Api.TypeBusinessChatLink): BusinessChatLinkSummary;
+export declare function summarizeBusinessChatLinks(result: Api.account.TypeBusinessChatLinks): BusinessChatLinksSummary;
+export type GroupCallInfoSummary = {
+    kind: "active";
+    id: string;
+    accessHash: string;
+    participantsCount: number;
+    title?: string;
+    scheduleDate?: number;
+    recordStartDate?: number;
+    streamDcId?: number;
+    unmutedVideoCount?: number;
+    unmutedVideoLimit: number;
+    version: number;
+    joinMuted?: boolean;
+    canChangeJoinMuted?: boolean;
+    joinDateAsc?: boolean;
+    scheduleStartSubscribed?: boolean;
+    canStartVideo?: boolean;
+    recordVideoActive?: boolean;
+    rtmpStream?: boolean;
+    listenersHidden?: boolean;
+} | {
+    kind: "discarded";
+    id: string;
+    accessHash: string;
+    duration: number;
+};
+export type GroupCallParticipantSummary = {
+    peer: CompactPeer | undefined;
+    date: number;
+    activeDate?: number;
+    source: number;
+    volume?: number;
+    muted?: boolean;
+    left?: boolean;
+    canSelfUnmute?: boolean;
+    justJoined?: boolean;
+    self?: boolean;
+    mutedByYou?: boolean;
+    volumeByAdmin?: boolean;
+    videoJoined?: boolean;
+    about?: string;
+    raiseHandRating?: string;
+    hasVideo?: boolean;
+    hasPresentation?: boolean;
+};
+export type GroupCallSummary = {
+    call: GroupCallInfoSummary;
+    participants: GroupCallParticipantSummary[];
+    participantsNextOffset?: string;
+};
+export type GroupCallParticipantsSummary = {
+    count: number;
+    participants: GroupCallParticipantSummary[];
+    nextOffset?: string;
+    version: number;
+};
+export declare function summarizeGroupCallInfo(call: Api.TypeGroupCall): GroupCallInfoSummary;
+export declare function summarizeGroupCallParticipant(p: Api.TypeGroupCallParticipant): GroupCallParticipantSummary;
+export declare function summarizeGroupCall(result: Api.phone.TypeGroupCall): GroupCallSummary;
+export declare function summarizeGroupCallParticipants(result: Api.phone.TypeGroupParticipants): GroupCallParticipantsSummary;
+export type StarsAmountSummary = {
+    amount: string;
+    nanos: number;
+};
+export type StarsTransactionPeerSummary = {
+    kind: "appStore";
+} | {
+    kind: "playMarket";
+} | {
+    kind: "premiumBot";
+} | {
+    kind: "fragment";
+} | {
+    kind: "ads";
+} | {
+    kind: "api";
+} | {
+    kind: "unsupported";
+} | {
+    kind: "peer";
+    peer: CompactPeer | undefined;
+};
+export type StarsTransactionSummary = {
+    id: string;
+    stars: StarsAmountSummary;
+    date: number;
+    peer: StarsTransactionPeerSummary;
+    refund?: boolean;
+    pending?: boolean;
+    failed?: boolean;
+    gift?: boolean;
+    reaction?: boolean;
+    title?: string;
+    description?: string;
+    msgId?: number;
+    subscriptionPeriod?: number;
+    giveawayPostId?: number;
+    transactionDate?: number;
+    transactionUrl?: string;
+};
+export type StarsSubscriptionPricingSummary = {
+    period: number;
+    amount: string;
+};
+export type StarsSubscriptionSummary = {
+    id: string;
+    peer: CompactPeer | undefined;
+    untilDate: number;
+    pricing: StarsSubscriptionPricingSummary;
+    canceled?: boolean;
+    canRefulfill?: boolean;
+    missingBalance?: boolean;
+    botCanceled?: boolean;
+    chatInviteHash?: string;
+    title?: string;
+    invoiceSlug?: string;
+};
+export type StarsStatusSummary = {
+    balance: StarsAmountSummary;
+    subscriptions?: StarsSubscriptionSummary[];
+    subscriptionsNextOffset?: string;
+    subscriptionsMissingBalance?: string;
+    history?: StarsTransactionSummary[];
+    nextOffset?: string;
+};
+export declare function summarizeStarsAmount(amount: Api.TypeStarsAmount): StarsAmountSummary;
+export declare function summarizeStarsTransactionPeer(peer: Api.TypeStarsTransactionPeer): StarsTransactionPeerSummary;
+export declare function summarizeStarsTransaction(tx: Api.TypeStarsTransaction): StarsTransactionSummary;
+export declare function summarizeStarsSubscription(sub: Api.TypeStarsSubscription): StarsSubscriptionSummary;
+export type QuickReplySummary = {
+    shortcutId: number;
+    shortcut: string;
+    topMessage: number;
+    count: number;
+};
+export type QuickRepliesSummary = {
+    notModified?: boolean;
+    quickReplies?: QuickReplySummary[];
+};
+export declare function summarizeQuickReply(reply: Api.TypeQuickReply): QuickReplySummary;
+export declare function summarizeQuickReplies(result: Api.messages.TypeQuickReplies): QuickRepliesSummary;
+export type QuickReplyMessageSummary = {
+    id: number;
+    date: number;
+    text: string;
+    isService: boolean;
+    fromId?: CompactPeer;
+    replyToMsgId?: number;
+};
+export type QuickReplyMessagesSummary = {
+    notModified?: boolean;
+    count?: number;
+    messages?: QuickReplyMessageSummary[];
+};
+export declare function summarizeQuickReplyMessage(msg: Api.TypeMessage): QuickReplyMessageSummary | null;
+export declare function summarizeQuickReplyMessages(result: Api.messages.TypeMessages): QuickReplyMessagesSummary;
+export declare function summarizeStarsStatus(result: Api.payments.TypeStarsStatus): StarsStatusSummary;
+export declare function summarizeStoryItem(item: Api.TypeStoryItem): StoryItemSummary;
+export declare function summarizePeerStories(ps: Api.TypePeerStories): PeerStoriesSummary | null;
+export declare function summarizeStoriesById(result: Api.stories.TypeStories): StoriesByIdSummary;
+export declare function summarizeStoryView(view: Api.TypeStoryView): StoryViewSummary;
+export declare function summarizeStoryViewsList(result: Api.stories.TypeStoryViewsList): StoryViewsListSummary;
+export declare function summarizeAllStories(result: Api.stories.TypeAllStories): AllStoriesSummary;
 export declare class TelegramService {
     private client;
     private apiId;
@@ -425,6 +877,86 @@ export declare class TelegramService {
     }>>;
     setChatPermissions(chatId: string, permissions: ChatPermissions): Promise<void>;
     setSlowMode(chatId: string, seconds: number): Promise<void>;
+    toggleChannelSignatures(chatId: string, enabled: boolean): Promise<void>;
+    toggleAntiSpam(chatId: string, enabled: boolean): Promise<void>;
+    toggleForumMode(chatId: string, enabled: boolean): Promise<void>;
+    togglePrehistoryHidden(chatId: string, hidden: boolean): Promise<void>;
+    setChatAvailableReactions(chatId: string, reactions: {
+        type: "all";
+        allowCustom?: boolean;
+    } | {
+        type: "some";
+        emoji: string[];
+    } | {
+        type: "none";
+    }): Promise<void>;
+    approveChatJoinRequest(chatId: string, userId: string, approved: boolean): Promise<void>;
+    getInlineBotResults(bot: string, chatId: string, query: string, offset?: string): Promise<{
+        queryId: string;
+        nextOffset?: string;
+        cacheTime: number;
+        gallery: boolean;
+        results: Array<{
+            id: string;
+            type: string;
+            title?: string;
+            description?: string;
+            url?: string;
+        }>;
+    }>;
+    sendInlineBotResult(chatId: string, queryId: string, resultId: string, options?: {
+        replyTo?: number;
+        silent?: boolean;
+        hideVia?: boolean;
+        clearDraft?: boolean;
+    }): Promise<{
+        messageId: number;
+    }>;
+    pressButton(chatId: string, messageId: number, options: {
+        buttonIndex?: {
+            row: number;
+            column: number;
+        };
+        data?: string;
+    }): Promise<{
+        alert?: boolean;
+        hasUrl?: boolean;
+        nativeUi?: boolean;
+        message?: string;
+        url?: string;
+        cacheTime: number;
+    }>;
+    getMessageButtons(chatId: string, messageId: number): Promise<{
+        markupType: string;
+        buttons: MessageButtonDescriptor[];
+    }>;
+    getBroadcastStats(chatId: string, options?: {
+        dark?: boolean;
+        includeGraphs?: boolean;
+    }): Promise<BroadcastStatsSummary>;
+    getMegagroupStats(chatId: string, options?: {
+        dark?: boolean;
+        includeGraphs?: boolean;
+    }): Promise<MegagroupStatsSummary>;
+    getUpdatesState(): Promise<{
+        pts: number;
+        qts: number;
+        date: number;
+        seq: number;
+        unreadCount: number;
+    }>;
+    getUpdates(cursor: {
+        pts: number;
+        date: number;
+        qts: number;
+        ptsLimit?: number;
+        ptsTotalLimit?: number;
+    }): Promise<UpdatesDifferenceSummary>;
+    getChannelUpdates(chatId: string, cursor: {
+        pts: number;
+        limit?: number;
+        force?: boolean;
+    }): Promise<ChannelDifferenceSummary>;
     createForumTopic(chatId: string, title: string, iconColor?: number, iconEmojiId?: string): Promise<{
         id: number;
         title: string;
@@ -525,4 +1057,52 @@ export declare class TelegramService {
         accessHash: string;
         emoji: string;
     }>>;
+    getAllStories(options?: {
+        next?: boolean;
+        hidden?: boolean;
+        state?: string;
+    }): Promise<AllStoriesSummary>;
+    getPeerStories(chatId: string): Promise<PeerStoriesSummary | null>;
+    getStoriesById(chatId: string, ids: number[]): Promise<StoriesByIdSummary>;
+    getStoryViewsList(chatId: string, options: {
+        id: number;
+        q?: string;
+        justContacts?: boolean;
+        reactionsFirst?: boolean;
+        forwardsFirst?: boolean;
+        offset?: string;
+        limit?: number;
+    }): Promise<StoryViewsListSummary>;
+    getMyBoosts(): Promise<MyBoostsSummary>;
+    getBoostsStatus(chatId: string): Promise<BoostsStatusSummary>;
+    getBoostsList(chatId: string, options?: {
+        gifts?: boolean;
+        offset?: string;
+        limit?: number;
+    }): Promise<BoostsListSummary>;
+    getBusinessChatLinks(): Promise<BusinessChatLinksSummary>;
+    getGroupCall(chatId: string, options?: {
+        limit?: number;
+    }): Promise<GroupCallSummary>;
+    getGroupCallParticipants(chatId: string, options?: {
+        ids?: string[];
+        sources?: number[];
+        offset?: string;
+        limit?: number;
+    }): Promise<GroupCallParticipantsSummary>;
+    getStarsStatus(chatId: string): Promise<StarsStatusSummary>;
+    getStarsTransactions(chatId: string, options?: {
+        inbound?: boolean;
+        outbound?: boolean;
+        ascending?: boolean;
+        subscriptionId?: string;
+        offset?: string;
+        limit?: number;
+    }): Promise<StarsStatusSummary>;
+    getQuickReplies(hash?: string): Promise<QuickRepliesSummary>;
+    getQuickReplyMessages(shortcutId: number, options?: {
+        ids?: number[];
+        hash?: string;
+    }): Promise<QuickReplyMessagesSummary>;
+    private resolveInputGroupCall;
 }