import type { RuntimeEnv } from "openclaw/plugin-sdk/runtime-env";

import { formatErrorMessage } from "openclaw/plugin-sdk/ssrf-runtime";

export type TelegramApiLogger = (message: string) => void;

type TelegramApiLogger = (message: string) => void;

type TelegramApiLoggingParams<T> = {

operation: string;

export const TELEGRAM_CALLBACK_DATA_MAX_BYTES = 64;

const TELEGRAM_CALLBACK_DATA_MAX_BYTES = 64;

const TELEGRAM_APPROVE_ALLOW_ALWAYS_PATTERN =

/^\/approve(?:@[^\s]+)?\s+[A-Za-z0-9][A-Za-z0-9._:-]*\s+allow-always$/i;

invalidEntries: string[];

};

export type AllowFromMatch = AllowlistMatch<"wildcard" | "id">;

type AllowFromMatch = AllowlistMatch<"wildcard" | "id">;

const warnedInvalidEntries = new Set<string>();

const log = createSubsystemLogger("telegram/bot-access");

info: (obj: Record<string, unknown>, msg: string) => void;

};

export type ResolveTelegramGroupConfig = (

type ResolveTelegramGroupConfig = (

chatId: string | number,

messageThreadId?: number,

) => {

groupConfig?: TelegramGroupConfig | TelegramDirectConfig;

topicConfig?: TelegramTopicConfig;

};

export type ResolveGroupActivation = (params: {

type ResolveGroupActivation = (params: {

chatId: string | number;

agentId?: string;

messageThreadId?: number;

sessionKey?: string;

}) => boolean | undefined;

export type ResolveGroupRequireMention = (chatId: string | number) => boolean;

type ResolveGroupRequireMention = (chatId: string | number) => boolean;

export type TelegramMessageContextRuntimeOverrides = Partial<

type TelegramMessageContextRuntimeOverrides = Partial<

Pick<

typeof import("./bot-message-context.runtime.js"),

| "createStatusReactionController"

export type TelegramMediaContextPayload = {

type TelegramMediaContextPayload = {

MediaPath?: string;

MediaUrl?: string;

MediaType?: string;

import { withTelegramApiErrorLogging } from "./api-logging.js";

import { normalizeTelegramCommandName, TELEGRAM_COMMAND_NAME_PATTERN } from "./command-config.js";

export const TELEGRAM_MAX_COMMANDS = 100;

const TELEGRAM_MAX_COMMANDS = 100;

export const TELEGRAM_TOTAL_COMMAND_TEXT_BUDGET = 5700;

const TELEGRAM_COMMAND_RETRY_RATIO = 0.8;

const TELEGRAM_MIN_COMMAND_DESCRIPTION_LENGTH = 1;

export type TelegramMenuCommand = {

type TelegramMenuCommand = {

command: string;

description: string;

};

| NonNullable<Message["document"]>

| NonNullable<Message["sticker"]>;

export type TelegramPrimaryMedia = {

type TelegramPrimaryMedia = {

placeholder: string;

fileRef: TelegramMediaFileRef;

};

import type { TelegramTextEntity } from "./body-helpers.js";

export const TELEGRAM_NATIVE_QUOTE_MAX_LENGTH = 1024;

const TELEGRAM_NATIVE_QUOTE_MAX_LENGTH = 1024;

export type TelegramNativeQuoteCandidate = {

type TelegramNativeQuoteCandidate = {

text: string;

position?: number;

entities?: unknown[];

}

}

export function markDelivered(progress: DeliveryProgress): void {

function markDelivered(progress: DeliveryProgress): void {

progress.hasDelivered = true;

}

/** App-specific stream mode for Telegram stream previews. */

export type TelegramStreamMode = "off" | "partial" | "block";

export type TelegramGetFile = () => Promise<{ file_path?: string }>;

type TelegramGetFile = () => Promise<{ file_path?: string }>;

export type TelegramChatDetails = {

id?: number | string;

available_reactions?: ChatFullInfo["available_reactions"] | null;