telegram

May 24, 2026

Changes in this version

type Bot

+ func (b *Bot) GetUpdatesContext(ctx context.Context, offset int, timeout int) ([]Update, error)

+ func (b *Bot) SetFileBaseURL(url string)

type TelegramConfig

+ AgentTimeout int

May 23, 2026

Changes in this version

type TelegramConfig

+ DefaultChatID int64

May 23, 2026

Changes in this version

type TelegramApprover

+ func (a *TelegramApprover) SetTrustAll(enabled bool)

May 23, 2026

Changes in this version

type TelegramApprover

+ func (a *TelegramApprover) Cancel()

May 22, 2026

Changes in this version

+ func CleanupMedia(maxAge time.Duration) (int, error)

+ func DownloadDocument(bot *Bot, fileID, fileName string) (string, error)

+ func IsFatalAPIError(err error) bool

type Bot

+ func (b *Bot) DeleteMessage(chatID int64, messageID int) error

+ func (b *Bot) SendDocument(chatID int64, path string, caption string, opts *SendOpts) (*Message, error)

type Handler

+ OnDocumentMessage func(chatID int64, messageID int, fileID string, fileName string) (string, error)

+ type HealthServer struct

+ func NewHealthServer(addr string) *HealthServer

+ func (hs *HealthServer) ServeHTTP(w http.ResponseWriter, r *http.Request)

+ func (hs *HealthServer) SetLogger(l Logger)

+ func (hs *HealthServer) SetReady()

+ func (hs *HealthServer) Start(ctx context.Context) error

type TelegramConfig

+ HealthAddr string

+ type TelegramError struct

+ Code int

+ Description string

+ Method string

+ func (e *TelegramError) Error() string

type Update

+ EditedMessage *Message

May 22, 2026

Changes in this version

type Bot

+ func (b *Bot) DailyTokenUsage() (used int64, limit int64)

May 21, 2026

Changes in this version

+ const ParseModeHTML

+ const ParseModeMarkdownV2

+ var DefaultCommands []CommandDescriptor

+ func DeletePlan(slugPrefix string) (string, error)

+ func DownloadPhoto(bot *Bot, fileIDs []string) (string, error)

+ func DownloadVoice(bot *Bot, fileID string) (string, error)

+ func EscapeMarkdown(text string) string

+ func FormatResponse(text string) ([]string, error)

+ func MediaDir() (string, error)

+ func MostRecentPlan() (string, string, error)

+ func ReadPlan(slugPrefix string) (string, string, error)

+ func RetryWithBackoff(fn func() error, maxAttempts int, baseDelay time.Duration) error

+ func Slugify(desc string) string

+ func ValidateConfig(cfg TelegramConfig) error

+ type Bot struct

+ BaseURL string

+ Client *http.Client

+ DailyTokenBudget int64

+ FileBaseURL string

+ Token string

+ func NewBot(token string) *Bot

+ func (b *Bot) AnswerCallbackQuery(callbackID string, text string, showAlert bool) error

+ func (b *Bot) CheckDailyBudget(tokens int64) error

+ func (b *Bot) DownloadFile(filePath string) ([]byte, error)

+ func (b *Bot) EditMessageText(chatID int64, messageID int, text string, opts *SendOpts) error

+ func (b *Bot) GetFile(fileID string) (*File, error)

+ func (b *Bot) GetMe() (*User, error)

+ func (b *Bot) GetUpdates(offset int, timeout int) ([]Update, error)

+ func (b *Bot) SendChatAction(chatID int64, action string) error

+ func (b *Bot) SendMessage(chatID int64, text string, opts *SendOpts) (*Message, error)

+ func (b *Bot) SendPhoto(chatID int64, path string, caption string) (*Message, error)

+ func (b *Bot) SendVoice(chatID int64, path string, caption string) (*Message, error)

+ func (b *Bot) SetDailyTokenBudget(budget int64)

+ func (b *Bot) SetFallbackURLs(urls []string)

+ func (b *Bot) SetLogger(l Logger)

+ func (b *Bot) SetMyCommands(commands []BotCommand) error

+ type BotCommand struct

+ Command string

+ Description string

+ func CommandDescriptors() []BotCommand

+ type CallbackQuery struct

+ Data string

+ From *User

+ ID string

+ Message *Message

+ type Chat struct

+ FirstName string

+ ID int64

+ LastName string

+ Title string

+ Type string

+ Username string

+ type ChatMember struct

+ Status string

+ User *User

+ type ChatSession struct

+ ChatID int64

+ CreatedAt time.Time

+ LastActive time.Time

+ Messages []llm.Message

+ SessionID string

+ TurnCount int

+ type CommandDescriptor struct

+ Command string

+ Description string

+ Handler func(args string) (string, error)

+ func FindCommand(name string) *CommandDescriptor

+ type Document struct

+ FileID string

+ FileName string

+ FileSize int

+ FileUniqueID string

+ MimeType string

+ type FallbackTransport struct

+ Client *http.Client

+ FallbackURLs []string

+ PrimaryURL string

+ Timeout time.Duration

+ func NewFallbackTransport(fallbackURLs []string) *FallbackTransport

+ func (ft *FallbackTransport) Do(req *http.Request) (*http.Response, error)

+ func (ft *FallbackTransport) RoundTrip(req *http.Request) (*http.Response, error)

+ func (ft *FallbackTransport) TestEndpoints() map[string]string

+ func (ft *FallbackTransport) WrapBot(bot *Bot) *Bot

+ type File struct

+ FileID string

+ FilePath string

+ FileSize int

+ FileUniqueID string

+ type FileResponse struct

+ OK bool

+ Result *File

+ type GetUpdatesResponse struct

+ OK bool

+ Result []Update

+ type Handler struct

+ Bot *Bot

+ Config HandlerConfig

+ OnCallbackQuery func(chatID int64, callbackData string) (string, error)

+ OnCommand func(chatID int64, command string, args string) (string, error)

+ OnError func(chatID int64, err error)

+ OnPhotoMessage func(chatID int64, fileIDs []string) (string, error)

+ OnTextMessage func(chatID int64, text string) (string, error)

+ OnVoiceMessage func(chatID int64, fileID string) (string, error)

+ func NewHandler(bot *Bot) *Handler

+ func (h *Handler) DeleteApprover(chatID int64)

+ func (h *Handler) GetApprover(chatID int64) *TelegramApprover

+ func (h *Handler) HandleUpdate(upd Update)

+ func (h *Handler) SendResponse(chatID int64, text string)

+ func (h *Handler) SetApprover(chatID int64, a *TelegramApprover)

+ func (h *Handler) SetLogger(l Logger)

+ type HandlerConfig struct

+ AllowedChats []int64

+ AllowedUsers []int64

+ BotUsername string

+ MaxMsgLength int

+ type InlineKeyboardButton struct

+ CallbackData string

+ Text string

+ URL string

+ type InlineKeyboardMarkup struct

+ InlineKeyboard [][]InlineKeyboardButton

+ type LogLevel int

+ const LogDebug

+ const LogError

+ const LogInfo

+ const LogWarn

+ func ParseLogLevel(s string) LogLevel

+ type Logger interface

+ Debug func(msg string, fields ...any)

+ Error func(msg string, fields ...any)

+ Info func(msg string, fields ...any)

+ Warn func(msg string, fields ...any)

+ With func(fields ...any) Logger

+ func NewFileLogger(level LogLevel, path string) Logger

+ func NewNopLogger() Logger

+ type Message struct

+ Chat *Chat

+ Date int

+ Document *Document

+ Entities []MessageEntity

+ From *User

+ ID int

+ Photo []PhotoSize

+ ReplyMarkup *InlineKeyboardMarkup

+ Text string

+ Voice *Voice

+ func (m *Message) IsCommand() bool

+ type MessageEntity struct

+ Length int

+ Offset int

+ Type string

+ URL string

+ User *User

+ type PhotoSize struct

+ FileID string

+ FileSize int

+ FileUniqueID string

+ Height int

+ Width int

+ type PlanInfo struct

+ ModTime time.Time

+ Path string

+ Preview string

+ Slug string

+ func ListPlans(limit int) ([]PlanInfo, error)

+ type Poller struct

+ Bot *Bot

+ Interval time.Duration

+ Offset int

+ Timeout int

+ func NewPoller(bot *Bot) *Poller

+ func (p *Poller) Poll(ctx context.Context) ([]Update, error)

+ func (p *Poller) SetLogger(l Logger)

+ func (p *Poller) Start(ctx context.Context, updates chan<- Update) error

+ type SendMessageResponse struct

+ OK bool

+ Result *Message

+ type SendOpts struct

+ DisableWebPagePreview bool

+ ParseMode string

+ ReplyMarkup *InlineKeyboardMarkup

+ ReplyToMessageID int

+ type SessionInfo struct

+ CreatedAt time.Time

+ ID string

+ Task string

+ Turns int

+ UpdatedAt time.Time

+ type SessionManager struct

+ BaseDir string

+ Cache map[int64]*ChatSession

+ Mu sync.RWMutex

+ SessionTTL time.Duration

+ Store *session.Store

+ func NewSessionManager(store *session.Store, ttl time.Duration) *SessionManager

+ func (sm *SessionManager) AppendMessage(chatID int64, role string, content string) error

+ func (sm *SessionManager) Delete(chatID int64) error

+ func (sm *SessionManager) DeleteClarifyChannel(chatID int64)

+ func (sm *SessionManager) GetClarifyChannel(chatID int64) (chan string, bool)

+ func (sm *SessionManager) GetOrCreate(chatID int64) (*ChatSession, error)

+ func (sm *SessionManager) ListSessions(limit int) ([]SessionInfo, error)

+ func (sm *SessionManager) Load(chatID int64) (*ChatSession, error)

+ func (sm *SessionManager) PrunePlans(days int) (int, error)

+ func (sm *SessionManager) PruneSessions(days int) (int, error)

+ func (sm *SessionManager) ResumeSession(chatID int64, sessionID string) (*ChatSession, error)

+ func (sm *SessionManager) Save(chatID int64, messages []llm.Message) error

+ func (sm *SessionManager) SetClarifyChannel(chatID int64, ch chan string)

+ type TelegramApprover struct

+ ChatID int64

+ func NewTelegramApprover(bot *Bot, chatID int64) *TelegramApprover

+ func (a *TelegramApprover) HandleCallback(data string) bool

+ func (a *TelegramApprover) IsTrusted(cls danger.RiskClass) bool

+ func (a *TelegramApprover) PromptCommand(cls danger.RiskClass, cmd, description string) error

+ func (a *TelegramApprover) PromptOperation(op danger.ToolOperation) error

+ func (a *TelegramApprover) ResetTrust()

+ func (a *TelegramApprover) SetLogger(l Logger)

+ type TelegramConfig struct

+ AllowedChats []int64

+ AllowedUsers []int64

+ BotUsername string

+ DailyTokenBudget int64

+ FallbackURLs []string

+ LogFile string

+ LogLevel string

+ MaxMsgLength int

+ PollInterval int

+ PollTimeout int

+ SessionTTL int

+ Token string

+ func ConfigFromEnv(base TelegramConfig) TelegramConfig

+ func DefaultConfig() TelegramConfig

+ type Update struct

+ CallbackQuery *CallbackQuery

+ ID int

+ Message *Message

+ type UpdateResponse struct

+ Description string

+ ErrorCode int

+ OK bool

+ Result json.RawMessage

+ type User struct

+ FirstName string

+ ID int64

+ IsBot bool

+ LastName string

+ Username string

+ type UserProfilePhotos struct

+ Photos [][]PhotoSize

+ TotalCount int

+ type Voice struct

+ Duration int

+ FileID string

+ FileSize int

+ FileUniqueID string

+ MimeType string

+ type WebhookInfo struct

+ URL string