Files
Memoh/internal/channel/adapters/telegram/directory.go
T
Ran 6acdd191c7 Squashed commit of the following:
commit bcdb026ae43e4f95d0b2c4f9bd440a2df9d6b514
Author: Ran <16112591+chen-ran@users.noreply.github.com>
Date:   Thu Feb 12 17:10:32 2026 +0800

    chore: update DEVELOPMENT.md

commit 30281742ef
Merge: ca5c6a1 5b05f13
Author: BBQ <bbq@BBQdeMacBook-Air.local>
Date:   Thu Feb 12 15:49:17 2026 +0800

    merge(github/main): integrate fx dependency injection framework

    Merge upstream fx refactor and adapt all services to use go.uber.org/fx
    for dependency injection. Resolve conflicts in main.go, server.go,
    and service constructors while preserving our domain model changes.

    - Fix telegram adapter panic on shutdown (double close channel)
    - Fix feishu adapter processing messages after stop
    - Increase directory lookup timeout from 2s to 5s

commit ca5c6a1866
Author: BBQ <bbq@BBQdeMacBook-Air.local>
Date:   Thu Feb 12 15:33:09 2026 +0800

    refactor(core): restructure conversation, channel and message domains

    - Rename chat module to conversation with flow-based architecture
    - Move channelidentities into channel/identities subpackage
    - Add channel/route for routing logic
    - Add message service with event hub
    - Add MCP providers: container, directory, schedule
    - Refactor Feishu/Telegram adapters with directory and stream support
    - Add platform management page and channel badges in web UI
    - Update database schema for conversations, messages and channel routes
    - Add @memoh/shared package for cross-package type definitions

commit 75e2ef0467
Merge: d99ba38 01cb6c8
Author: BBQ <bbq@BBQdeMacBook-Air.local>
Date:   Thu Feb 12 14:45:49 2026 +0800

    merge(github): merge github/main, resolve index.ts URL conflict

    Keep our defensive absolute-URL check in createAuthFetcher.

commit d99ba38b7d
Merge: 860e20f 35ce7d1
Author: BBQ <bbq@BBQdeMacBook-Air.local>
Date:   Thu Feb 12 05:20:18 2026 +0800

    merge(github): merge github/main, keep our code and docs/spec

commit 860e20fe70
Author: BBQ <bbq@BBQdeMacBook-Air.local>
Date:   Wed Feb 11 22:13:27 2026 +0800

    docs(docs): add concepts and style guides for VitePress site

    - Add concepts: identity-and-binding, index (en/zh)
    - Add style: terminology (en/zh)
    - Update index and zh/index
    - Update .vitepress/config.ts

commit a75fdb8040
Author: BBQ <bbq@BBQdeMacBook-Air.local>
Date:   Wed Feb 11 17:37:16 2026 +0800

    refactor(mcp): standardize unified tool gateway on go-sdk

    Split business executors from federation sources and migrate unified tool/federation transports to the official go-sdk for stricter MCP compliance and safer session lifecycle handling. Add targeted regression tests for accept compatibility, initialization retries, pending cleanup, and include updated swagger artifacts.

commit 02b33c8e85
Author: BBQ <bbq@BBQdeMacBook-Air.local>
Date:   Wed Feb 11 15:42:21 2026 +0800

    refactor(core): finalize user-centric identity and policy cleanup

    Unify auth and chat identity semantics around user_id, enforce personal-bot owner-only authorization, and remove legacy compatibility branches in integration tests.

commit 06e8619a37
Author: BBQ <bbq@BBQdeMacBook-Air.local>
Date:   Wed Feb 11 14:47:03 2026 +0800

    refactor(core): migrate channel identity and binding across app

    Align channel identity and bind flow across backend and app-facing layers, including generated swagger artifacts and package lock updates while excluding docs content changes.
2026-02-12 17:13:03 +08:00

240 lines
7.6 KiB
Go

package telegram
import (
"context"
"fmt"
"strconv"
"strings"
tgbotapi "github.com/go-telegram-bot-api/telegram-bot-api/v5"
"github.com/memohai/memoh/internal/channel"
)
const (
defaultDirectoryLimit = 50
maxDirectoryLimit = 200
)
func directoryLimit(n int) int {
if n <= 0 {
return defaultDirectoryLimit
}
if n > maxDirectoryLimit {
return maxDirectoryLimit
}
return n
}
// ListPeers returns users the bot can reach. Telegram Bot API does not provide a list of users; returns empty.
func (a *TelegramAdapter) ListPeers(ctx context.Context, cfg channel.ChannelConfig, query channel.DirectoryQuery) ([]channel.DirectoryEntry, error) {
return nil, nil
}
// ListGroups returns chats the bot is in. Telegram Bot API does not provide a list of chats; returns empty.
func (a *TelegramAdapter) ListGroups(ctx context.Context, cfg channel.ChannelConfig, query channel.DirectoryQuery) ([]channel.DirectoryEntry, error) {
return nil, nil
}
// ListGroupMembers returns administrators of the given group (Telegram only exposes admin list, not full members).
func (a *TelegramAdapter) ListGroupMembers(ctx context.Context, cfg channel.ChannelConfig, groupID string, query channel.DirectoryQuery) ([]channel.DirectoryEntry, error) {
telegramCfg, err := parseConfig(cfg.Credentials)
if err != nil {
return nil, err
}
bot, err := a.getOrCreateBot(telegramCfg.BotToken, cfg.ID)
if err != nil {
return nil, err
}
chatID, superGroupUsername := parseTelegramChatInput(strings.TrimSpace(groupID))
if chatID == 0 && superGroupUsername == "" {
return nil, fmt.Errorf("telegram list group members: invalid group id %q", groupID)
}
config := tgbotapi.ChatAdministratorsConfig{
ChatConfig: tgbotapi.ChatConfig{ChatID: chatID, SuperGroupUsername: superGroupUsername},
}
members, err := bot.GetChatAdministrators(config)
if err != nil {
return nil, fmt.Errorf("telegram get chat administrators: %w", err)
}
limit := directoryLimit(query.Limit)
entries := make([]channel.DirectoryEntry, 0, limit)
for i, m := range members {
if i >= limit {
break
}
if m.User == nil {
continue
}
e := telegramUserToEntry(m.User)
if query.Query != "" && !strings.Contains(strings.ToLower(e.Name+e.Handle), strings.ToLower(query.Query)) {
continue
}
entries = append(entries, e)
}
return entries, nil
}
// ResolveEntry resolves an input string to a user or group DirectoryEntry using getChat / getChatMember.
func (a *TelegramAdapter) ResolveEntry(ctx context.Context, cfg channel.ChannelConfig, input string, kind channel.DirectoryEntryKind) (channel.DirectoryEntry, error) {
telegramCfg, err := parseConfig(cfg.Credentials)
if err != nil {
return channel.DirectoryEntry{}, err
}
bot, err := a.getOrCreateBot(telegramCfg.BotToken, cfg.ID)
if err != nil {
return channel.DirectoryEntry{}, err
}
input = strings.TrimSpace(input)
switch kind {
case channel.DirectoryEntryUser:
return a.resolveTelegramUser(ctx, bot, input)
case channel.DirectoryEntryGroup:
return a.resolveTelegramGroup(ctx, bot, input)
default:
return channel.DirectoryEntry{}, fmt.Errorf("telegram resolve entry: unsupported kind %q", kind)
}
}
func (a *TelegramAdapter) resolveTelegramUser(ctx context.Context, bot *tgbotapi.BotAPI, input string) (channel.DirectoryEntry, error) {
chatID, userID := parseTelegramUserInput(input)
if chatID == 0 && userID == 0 {
return channel.DirectoryEntry{}, fmt.Errorf("telegram resolve entry user: invalid input %q", input)
}
if userID != 0 {
config := tgbotapi.GetChatMemberConfig{
ChatConfigWithUser: tgbotapi.ChatConfigWithUser{
ChatID: chatID,
SuperGroupUsername: "",
UserID: userID,
},
}
member, err := bot.GetChatMember(config)
if err != nil {
return channel.DirectoryEntry{}, fmt.Errorf("telegram get chat member: %w", err)
}
if member.User == nil {
return channel.DirectoryEntry{}, fmt.Errorf("telegram get chat member: empty user")
}
return telegramUserToEntry(member.User), nil
}
chatConfig := tgbotapi.ChatInfoConfig{ChatConfig: tgbotapi.ChatConfig{ChatID: chatID}}
chat, err := bot.GetChat(chatConfig)
if err != nil {
return channel.DirectoryEntry{}, fmt.Errorf("telegram get chat: %w", err)
}
if !chat.IsPrivate() {
return channel.DirectoryEntry{}, fmt.Errorf("telegram resolve entry user: chat %d is not private", chatID)
}
name := strings.TrimSpace(chat.FirstName + " " + chat.LastName)
if name == "" {
name = strings.TrimSpace(chat.Title)
}
handle := strings.TrimSpace(chat.UserName)
if handle != "" && !strings.HasPrefix(handle, "@") {
handle = "@" + handle
}
idStr := strconv.FormatInt(chat.ID, 10)
return channel.DirectoryEntry{
Kind: channel.DirectoryEntryUser,
ID: idStr,
Name: name,
Handle: handle,
Metadata: map[string]any{
"chat_id": idStr,
"username": chat.UserName,
},
}, nil
}
func (a *TelegramAdapter) resolveTelegramGroup(ctx context.Context, bot *tgbotapi.BotAPI, input string) (channel.DirectoryEntry, error) {
chatID, superGroupUsername := parseTelegramChatInput(input)
if chatID == 0 && superGroupUsername == "" {
return channel.DirectoryEntry{}, fmt.Errorf("telegram resolve entry group: invalid input %q", input)
}
config := tgbotapi.ChatInfoConfig{
ChatConfig: tgbotapi.ChatConfig{ChatID: chatID, SuperGroupUsername: superGroupUsername},
}
chat, err := bot.GetChat(config)
if err != nil {
return channel.DirectoryEntry{}, fmt.Errorf("telegram get chat: %w", err)
}
idStr := strconv.FormatInt(chat.ID, 10)
name := strings.TrimSpace(chat.Title)
if name == "" {
name = strings.TrimSpace(chat.FirstName + " " + chat.LastName)
}
handle := strings.TrimSpace(chat.UserName)
if handle != "" && !strings.HasPrefix(handle, "@") {
handle = "@" + handle
}
return channel.DirectoryEntry{
Kind: channel.DirectoryEntryGroup,
ID: idStr,
Name: name,
Handle: handle,
Metadata: map[string]any{"chat_id": idStr, "type": chat.Type},
}, nil
}
// parseTelegramChatInput parses input as chat_id (numeric) or @channel_username. Returns (chatID, superGroupUsername).
func parseTelegramChatInput(input string) (chatID int64, superGroupUsername string) {
input = strings.TrimSpace(input)
if input == "" {
return 0, ""
}
if strings.HasPrefix(input, "@") {
return 0, input
}
id, err := strconv.ParseInt(input, 10, 64)
if err != nil {
return 0, ""
}
return id, ""
}
// parseTelegramUserInput parses input as "chat_id" (private chat) or "chat_id:user_id". Returns (chatID, userID); userID 0 means resolve as private chat.
func parseTelegramUserInput(input string) (chatID, userID int64) {
input = strings.TrimSpace(input)
if input == "" {
return 0, 0
}
if idx := strings.Index(input, ":"); idx >= 0 {
left := strings.TrimSpace(input[:idx])
right := strings.TrimSpace(input[idx+1:])
cid, err1 := strconv.ParseInt(left, 10, 64)
uid, err2 := strconv.ParseInt(right, 10, 64)
if err1 == nil && err2 == nil && cid != 0 && uid != 0 {
return cid, uid
}
}
id, err := strconv.ParseInt(input, 10, 64)
if err != nil {
return 0, 0
}
return id, 0
}
func telegramUserToEntry(u *tgbotapi.User) channel.DirectoryEntry {
if u == nil {
return channel.DirectoryEntry{Kind: channel.DirectoryEntryUser}
}
name := strings.TrimSpace(u.FirstName + " " + u.LastName)
handle := strings.TrimSpace(u.UserName)
if handle != "" && !strings.HasPrefix(handle, "@") {
handle = "@" + handle
}
idStr := strconv.FormatInt(u.ID, 10)
meta := map[string]any{"user_id": idStr}
if u.UserName != "" {
meta["username"] = u.UserName
}
return channel.DirectoryEntry{
Kind: channel.DirectoryEntryUser,
ID: idStr,
Name: name,
Handle: handle,
Metadata: meta,
}
}