@xopcai/xopc 0.0.99 → 0.0.100

package/dist/extensions/telegram/src/inbound-processor.js

@@ -1,9 +1,15 @@
+import { resolveRoute } from "../../../src/routing/resolve-route.js";
 import { createLogger } from "../../../src/utils/logger/index.js";
 import { init_logger } from "../../../src/utils/logger.js";
 import { normalizeTelegramCommandName, parseSlashCommand } from "../../../src/chat-commands/command-parse.js";
 import { checkMentionInTranscription } from "../../../src/voice/stt/preflight.js";
+import "../../../src/voice/stt/index.js";
 import { tryConsumeTelegramClarifyFreeText } from "../../../src/gateway/clarify-runtime.js";
 import { buildTelegramUpdateKey, telegramUpdateDedupe } from "./dedupe.js";
+import "../../../src/routing/index.js";
+import { resolveTelegramGroupContext } from "./group-config-resolver.js";
+import { buildTelegramConversationId } from "./conversation-id.js";
+import { resolveTelegramFocusedSessionKey } from "./focus-handler.js";
 //#region extensions/telegram/src/inbound-processor.ts
 init_logger();
 const log = createLogger("TelegramInboundProcessor");
@@ -41,6 +47,11 @@ function extractMediaItems(message) {
 		type: "voice",
 		fileId: message.voice.file_id
 	});
+	if (message.sticker) media.push({
+		type: "sticker",
+		fileId: message.sticker.file_id,
+		emoji: message.sticker.emoji
+	});
 	return media;
 }
 /**
@@ -196,7 +207,7 @@ function createInboundProcessor(deps) {
 			log.warn({ accountId }, "Bot username not available");
 			return;
 		}
-		const message = ctx.message;
+		const message = ctx.message ?? ctx.channelPost;
 		if (!message) return;
 		const chatId = String(ctx.chat?.id);
 		const senderId = String(ctx.from?.id);
@@ -277,14 +288,35 @@ function createInboundProcessor(deps) {
 			}
 		}
 		const cleanContent = isGroup ? accessControl.removeBotMention(content, botUsername) : content;
-		const sessionKey = sessionKeyService.generateSessionKey({
+		const groupCtx = resolveTelegramGroupContext({
+			account,
+			chatId,
+			threadId
+		});
+		const route = resolveRoute({
+			config,
+			channel: "telegram",
+			accountId,
+			peerKind: isGroup ? "group" : "dm",
+			peerId: isGroup ? chatId : senderId,
+			threadId: threadId ? String(threadId) : null
+		});
+		const routedAgentId = groupCtx.agentId ?? route.agentId;
+		const defaultSessionKey = sessionKeyService.generateSessionKey({
 			source: "telegram",
 			chatId,
 			senderId,
 			isGroup,
 			threadId: threadId ? String(threadId) : void 0,
-			accountId
+			accountId,
+			agentId: routedAgentId
+		});
+		const sessionKey = resolveTelegramFocusedSessionKey({
+			chatId,
+			threadId: threadId ? String(threadId) : void 0,
+			defaultSessionKey
 		});
+		const conversationId = buildTelegramConversationId(chatId, threadId);
 		const media = extractMediaItems(message);
 		const bot = accountManager.getBot(accountId);
 		const botToken = account.botToken;
@@ -296,7 +328,9 @@ function createInboundProcessor(deps) {
 			transcribedText = mediaResult.transcribedText;
 		}
 		const captionIsCommand = cleanContent.trim().startsWith("/");
-		const finalContent = transcribedText ? captionIsCommand && cleanContent ? cleanContent.trim() + (transcribedText ? `\n\n${transcribedText}` : "") : transcribedText + (cleanContent ? "\n\n" + cleanContent : "") : cleanContent;
+		let finalContent = transcribedText ? captionIsCommand && cleanContent ? cleanContent.trim() + (transcribedText ? `\n\n${transcribedText}` : "") : transcribedText + (cleanContent ? "\n\n" + cleanContent : "") : cleanContent;
+		const stickerItem = media.find((m) => m.type === "sticker");
+		if (stickerItem && !finalContent.trim()) finalContent = stickerItem.emoji?.trim() ? `[Sticker ${stickerItem.emoji}]` : "[Sticker]";
 		const isCommand = cleanContent.trim().startsWith("/");
 		log.info({
 			accountId,
@@ -325,6 +359,9 @@ function createInboundProcessor(deps) {
 				isGroup,
 				isCommand,
 				threadId: threadId ? String(threadId) : void 0,
+				conversationId,
+				channelSystemPrompt: groupCtx.systemPrompt,
+				channelAgentId: routedAgentId,
 				media: media.length > 0 ? media : void 0,
 				transcribedVoice: !!transcribedText || void 0
 			},

package/dist/extensions/telegram/src/inbound-processor.js.map

@@ -1 +1 @@
-{"version":3,"file":"inbound-processor.js","names":[],"sources":["../../../../extensions/telegram/src/inbound-processor.ts"],"sourcesContent":["/**\n * Telegram Inbound Processor\n *\n * Handles inbound message processing from Telegram:\n * - Message queuing (per chat)\n * - Deduplication\n * - Access control\n * - Media download\n * - STT transcription\n * - Event publishing to bus\n */\n\nimport type { Bot, Context } from 'grammy';\nimport type { Message } from '@grammyjs/types';\nimport type { Config } from '@xopcai/xopc/config/schema.js';\nimport type { MessageBus } from '@xopcai/xopc/infra/bus/index.js';\nimport type { TelegramAccountManager } from './account-manager.js';\nimport { telegramUpdateDedupe, buildTelegramUpdateKey } from './dedupe.js';\nimport { createLogger } from '@xopcai/xopc/utils/logger.js';\nimport { normalizeTelegramCommandName, parseSlashCommand } from '@xopcai/xopc/chat-commands/command-parse.js';\nimport { tryConsumeTelegramClarifyFreeText } from '@xopcai/xopc/gateway/clarify-runtime.js';\nimport { checkMentionInTranscription } from '@xopcai/xopc/voice/stt/preflight.js';\n\nconst log = createLogger('TelegramInboundProcessor');\n\n/** Must bypass the per-chat queue so /abort can cancel an in-flight turn. */\nfunction isAbortSlashCommand(text: string): boolean {\n  const parsed = parseSlashCommand(text);\n  if (!parsed) return false;\n  const cmd = normalizeTelegramCommandName(parsed.command);\n  return cmd === 'abort' || cmd === 'stop' || cmd === 'cancel';\n}\n\n/** Maximum voice message duration for STT in seconds */\nconst STT_MAX_VOICE_DURATION_SECONDS = 60;\n\n// =============================================================================\n// External Service Interfaces (for dependency injection)\n// =============================================================================\n\nexport interface AccessControlService {\n  normalizeAllowFromWithStore(options: { allowFrom?: Array<string | number> }): unknown;\n  evaluateGroupBaseAccess(options: {\n    isGroup: boolean;\n    groupConfig?: unknown;\n    topicConfig?: unknown;\n    hasGroupAllowOverride: boolean;\n    effectiveGroupAllow: unknown;\n    senderId?: string;\n    senderUsername?: string;\n  }): { allowed: boolean; reason?: string };\n  resolveRequireMention(options: {\n    topicConfig?: unknown;\n    groupConfig?: unknown;\n    defaultRequireMention?: boolean;\n  }): boolean;\n  hasBotMention(options: { botUsername: string; text?: string; entities?: unknown }): boolean;\n  removeBotMention(text: string, botUsername: string): string;\n}\n\nexport interface SessionKeyService {\n  generateSessionKey(options: {\n    source: string;\n    chatId: string;\n    senderId: string;\n    isGroup: boolean;\n    threadId?: string;\n    accountId?: string;\n  }): string;\n}\n\nexport interface STTService {\n  transcribe(buffer: Buffer, config: unknown, options?: { language?: string }): Promise<{ text: string }>;\n  isSTTAvailable(config: unknown): boolean;\n}\n\nexport interface MediaUtils {\n  getMimeType(type: string, filePath?: string): string;\n}\n\n// =============================================================================\n// Dependencies Interface\n// =============================================================================\n\nexport interface InboundProcessorDeps {\n  bus: MessageBus;\n  config: Config;\n  accountManager: TelegramAccountManager;\n  // External services (injected for testability)\n  accessControl: AccessControlService;\n  sessionKeyService: SessionKeyService;\n  sttService: STTService;\n  mediaUtils: MediaUtils;\n}\n\ninterface QueuedMessage {\n  ctx: Context;\n  accountId: string;\n  resolve: () => void;\n  reject: (err: Error) => void;\n}\n\n// =============================================================================\n// Media Processing Types\n// =============================================================================\n\ninterface MediaItem {\n  type: string;\n  fileId: string;\n}\n\ninterface ProcessedAttachment {\n  type: string;\n  mimeType: string;\n  data: string;\n  name?: string;\n  size?: number;\n}\n\n// =============================================================================\n// Helper Functions (reduce nesting in main processor)\n// =============================================================================\n\n/**\n * Extract media items from message\n */\nfunction extractMediaItems(message: Message): MediaItem[] {\n  const media: MediaItem[] = [];\n  \n  if (message.photo?.length) {\n    media.push({ type: 'photo', fileId: message.photo[message.photo.length - 1].file_id });\n  }\n  if (message.document) {\n    media.push({ type: 'document', fileId: message.document.file_id });\n  }\n  if (message.video) {\n    media.push({ type: 'video', fileId: message.video.file_id });\n  }\n  if (message.audio) {\n    media.push({ type: 'audio', fileId: message.audio.file_id });\n  }\n  if (message.voice) {\n    media.push({ type: 'voice', fileId: message.voice.file_id });\n  }\n  \n  return media;\n}\n\n/**\n * Download + STT a Telegram voice message (for mention probe or media pipeline).\n */\nasync function downloadAndTranscribeTelegramVoice(params: {\n  voice: NonNullable<Message['voice']>;\n  bot: Bot;\n  botToken: string;\n  accountApiRoot: string;\n  sttService: STTService;\n  sttConfig: unknown;\n}): Promise<string> {\n  const { voice, bot, botToken, accountApiRoot, sttService, sttConfig } = params;\n  const voiceDuration = voice.duration || 0;\n  if (voiceDuration > STT_MAX_VOICE_DURATION_SECONDS) {\n    return '';\n  }\n  if (!sttService.isSTTAvailable(sttConfig)) {\n    return '';\n  }\n  try {\n    const file = await bot.api.getFile(voice.file_id);\n    const downloadUrl = `${accountApiRoot}/file/bot${botToken}/${file.file_path}`;\n    const response = await fetch(downloadUrl);\n    if (!response.ok) {\n      return '';\n    }\n    const buffer = Buffer.from(await response.arrayBuffer());\n    if (buffer.length === 0) {\n      return '';\n    }\n    const sttResult = await sttService.transcribe(buffer, sttConfig, {\n      language: (sttConfig as { provider?: string })?.provider === 'alibaba' ? 'zh' : undefined,\n    });\n    return sttResult.text?.trim() ?? '';\n  } catch {\n    return '';\n  }\n}\n\n/**\n * Process a single media item (download + optional STT)\n */\nasync function processMediaItem(\n  item: MediaItem,\n  bot: Bot,\n  botToken: string,\n  accountApiRoot: string,\n  message: Message,\n  sttService: STTService,\n  mediaUtils: MediaUtils,\n  sttConfig: unknown,\n  reuseVoiceTranscript?: string,\n): Promise<{ attachment: ProcessedAttachment | null; transcribedText: string }> {\n  try {\n    const file = await bot.api.getFile(item.fileId);\n    const downloadUrl = `${accountApiRoot}/file/bot${botToken}/${file.file_path}`;\n    const response = await fetch(downloadUrl);\n\n    // Debug log for media download\n    log.info({\n      type: item.type,\n      fileId: item.fileId,\n      downloadUrl,\n      responseStatus: response.status,\n    }, 'Media download response');\n\n    if (!response.ok) {\n      throw new Error(`Failed to download: ${response.status}`);\n    }\n\n    const buffer = await response.arrayBuffer();\n\n    // Debug log for buffer size\n    log.info({\n      type: item.type,\n      fileId: item.fileId,\n      bufferSize: buffer.byteLength,\n      filePath: file.file_path,\n    }, 'Media buffer downloaded');\n\n    if (buffer.byteLength === 0) {\n      log.warn({\n        type: item.type,\n        fileId: item.fileId,\n        filePath: file.file_path,\n      }, 'Media buffer is empty, may cause issues');\n    }\n    let transcribedText = '';\n\n    // Handle voice messages with STT\n    if (item.type === 'voice' && sttService.isSTTAvailable(sttConfig)) {\n      if (reuseVoiceTranscript !== undefined && reuseVoiceTranscript !== '') {\n        transcribedText = reuseVoiceTranscript;\n      } else {\n        const voiceDuration = message.voice?.duration || 0;\n        if (voiceDuration <= STT_MAX_VOICE_DURATION_SECONDS) {\n          try {\n            const sttResult = await sttService.transcribe(Buffer.from(buffer), sttConfig, {\n              language: (sttConfig as { provider?: string })?.provider === 'alibaba' ? 'zh' : undefined,\n            });\n            transcribedText = sttResult.text;\n          } catch (sttError) {\n            log.error({ sttError }, 'STT transcription failed');\n            transcribedText = '[STT failed]';\n          }\n        } else {\n          transcribedText = `[Voice message too long (>${STT_MAX_VOICE_DURATION_SECONDS}s)]`;\n        }\n      }\n    }\n\n    const base64 = Buffer.from(buffer).toString('base64');\n    const mimeType = mediaUtils.getMimeType(item.type, file.file_path);\n\n    // Debug log for attachment creation\n    log.info({\n      type: item.type,\n      mimeType,\n      base64Length: base64.length,\n      size: buffer.byteLength,\n      name: file.file_path?.split('/').pop(),\n    }, 'Attachment created');\n\n    return {\n      attachment: {\n        type: item.type,\n        mimeType,\n        data: base64,\n        name: file.file_path?.split('/').pop(),\n        size: buffer.byteLength,\n      },\n      transcribedText,\n    };\n  } catch (err) {\n    log.error({ type: item.type, fileId: item.fileId, err }, 'Failed to download media');\n    return { attachment: null, transcribedText: '' };\n  }\n}\n\n/**\n * Process all media items\n */\nasync function processAllMedia(\n  media: MediaItem[],\n  bot: Bot,\n  botToken: string,\n  accountApiRoot: string,\n  message: Message,\n  sttService: STTService,\n  mediaUtils: MediaUtils,\n  sttConfig: unknown,\n  reuseVoiceTranscript?: string,\n): Promise<{ attachments: ProcessedAttachment[]; transcribedText: string }> {\n  const attachments: ProcessedAttachment[] = [];\n  let transcribedText = '';\n  let voiceReuseConsumed = false;\n\n  for (const item of media) {\n    const reuse =\n      item.type === 'voice' && reuseVoiceTranscript && !voiceReuseConsumed\n        ? reuseVoiceTranscript\n        : undefined;\n    if (reuse) {\n      voiceReuseConsumed = true;\n    }\n    const result = await processMediaItem(\n      item,\n      bot,\n      botToken,\n      accountApiRoot,\n      message,\n      sttService,\n      mediaUtils,\n      sttConfig,\n      reuse,\n    );\n    \n    if (result.attachment) {\n      attachments.push(result.attachment);\n    }\n    if (result.transcribedText) {\n      transcribedText = result.transcribedText;\n    }\n  }\n\n  return { attachments, transcribedText };\n}\n\n// =============================================================================\n// Main Processor Factory\n// =============================================================================\n\n/**\n * Create inbound message processor\n */\nexport function createInboundProcessor(deps: InboundProcessorDeps) {\n  const {\n    bus,\n    config,\n    accountManager,\n    accessControl,\n    sessionKeyService,\n    sttService,\n    mediaUtils,\n  } = deps;\n\n  const messageQueues = new Map<string, QueuedMessage[]>();\n  const processingLocks = new Map<string, Promise<void>>();\n\n  const getChatKey = (accountId: string, chatId: string): string => `${accountId}:${chatId}`;\n\n  const processNextMessage = async (chatKey: string): Promise<void> => {\n    if (processingLocks.has(chatKey)) return;\n\n    const queue = messageQueues.get(chatKey);\n    if (!queue || queue.length === 0) return;\n\n    let lockResolve: () => void;\n    const lockPromise = new Promise<void>((resolve) => {\n      lockResolve = resolve;\n    });\n    processingLocks.set(chatKey, lockPromise);\n\n    const { ctx, accountId, resolve, reject } = queue.shift()!;\n\n    try {\n      await processMessageInternal(ctx, accountId);\n      resolve();\n    } catch (err) {\n      reject(err instanceof Error ? err : new Error(String(err)));\n    } finally {\n      lockResolve?.();\n      processingLocks.delete(chatKey);\n      if (queue.length > 0) {\n        processNextMessage(chatKey);\n      } else {\n        messageQueues.delete(chatKey);\n      }\n    }\n  };\n\n  const processMessageInternal = async (ctx: Context, accountId: string) => {\n    // Deduplication check\n    const updateKey = buildTelegramUpdateKey(ctx);\n    if (updateKey && telegramUpdateDedupe.checkAndAdd(updateKey)) {\n      log.debug({ updateKey, accountId }, 'Duplicate update detected, skipping');\n      return;\n    }\n\n    const account = accountManager.getAccount(accountId);\n    if (!account) {\n      log.warn({ accountId }, 'Account not found for message processing');\n      return;\n    }\n\n    const botUsername = accountManager.getBotUsername(accountId);\n    if (!botUsername) {\n      log.warn({ accountId }, 'Bot username not available');\n      return;\n    }\n\n    const message = ctx.message;\n    if (!message) return;\n\n    const chatId = String(ctx.chat?.id);\n    const senderId = String(ctx.from?.id);\n    const senderUsername = ctx.from?.username;\n    const content = message.text ?? message.caption ?? '';\n    const isGroup = ctx.chat?.type === 'group' || ctx.chat?.type === 'supergroup';\n    const threadId = (message as { message_thread_id?: number }).message_thread_id;\n\n    // Access control (group/topic allowlists, mention gating)\n    const effectiveAllowFrom = accessControl.normalizeAllowFromWithStore({\n      allowFrom: isGroup ? account.groupAllowFrom : account.allowFrom,\n    });\n\n    const baseAccess = accessControl.evaluateGroupBaseAccess({\n      isGroup,\n      groupConfig: account.groups?.[chatId],\n      topicConfig: threadId ? account.groups?.[chatId]?.topics?.[String(threadId)] : undefined,\n      hasGroupAllowOverride: !!(account.groups?.[chatId]?.allowFrom ||\n        (threadId && account.groups?.[chatId]?.topics?.[String(threadId)]?.allowFrom)),\n      effectiveGroupAllow: effectiveAllowFrom,\n      senderId,\n      senderUsername,\n    });\n\n    if (!baseAccess.allowed) {\n      log.debug({ accountId, chatId, reason: baseAccess.reason }, 'Message blocked by base access');\n      return;\n    }\n\n    const botEarly = accountManager.getBot(accountId);\n    const botTokenEarly = account.botToken;\n    const accountApiRootEarly = account.apiRoot?.replace(/\\/$/, '') || 'https://api.telegram.org';\n\n    let voiceProbeText = '';\n    if (\n      isGroup &&\n      message.voice &&\n      botEarly &&\n      botTokenEarly &&\n      sttService.isSTTAvailable(config?.tools?.media?.audio)\n    ) {\n      voiceProbeText = await downloadAndTranscribeTelegramVoice({\n        voice: message.voice,\n        bot: botEarly,\n        botToken: botTokenEarly,\n        accountApiRoot: accountApiRootEarly,\n        sttService,\n        sttConfig: config?.tools?.media?.audio,\n      });\n    }\n\n    if (isGroup) {\n      const requireMention = accessControl.resolveRequireMention({\n        topicConfig: threadId ? account.groups?.[chatId]?.topics?.[String(threadId)] : undefined,\n        groupConfig: account.groups?.[chatId],\n        defaultRequireMention: true,\n      });\n\n      const hasMedia = !!(message.photo || message.document || message.video || message.audio || message.voice);\n      const captionEntities = (message as any).caption_entities;\n      const voiceMention = voiceProbeText.trim();\n      const hasMention =\n        accessControl.hasBotMention({ botUsername, text: content, entities: message.entities }) ||\n        (hasMedia &&\n          accessControl.hasBotMention({\n            botUsername,\n            text: message.caption ?? '',\n            entities: captionEntities,\n          })) ||\n        (voiceMention.length > 0 &&\n          (accessControl.hasBotMention({ botUsername, text: voiceMention }) ||\n            checkMentionInTranscription(voiceMention, [botUsername])));\n\n      if (requireMention && !hasMention) {\n        const isVoiceOnly =\n          !!message.voice &&\n          !message.photo &&\n          !message.document &&\n          !message.video &&\n          !message.audio &&\n          !(message.caption ?? '').trim() &&\n          !content.trim();\n\n        if (isVoiceOnly) {\n          log.debug({ accountId, chatId }, 'Group voice without mention after STT probe, ignored');\n          return;\n        }\n\n        if (!hasMedia || content.trim().length > 0) {\n          log.debug({ accountId, chatId }, 'Group message without mention ignored');\n          return;\n        }\n        log.debug({ accountId, chatId }, 'Group media message without mention - processing anyway');\n      }\n    }\n\n    const cleanContent = isGroup ? accessControl.removeBotMention(content, botUsername) : content;\n\n    // Generate session key\n    const sessionKey = sessionKeyService.generateSessionKey({\n      source: 'telegram',\n      chatId,\n      senderId,\n      isGroup,\n      threadId: threadId ? String(threadId) : undefined,\n      accountId,\n    });\n\n    // Collect and process media\n    const media = extractMediaItems(message);\n    const bot = accountManager.getBot(accountId);\n    const botToken = account.botToken;\n\n    let attachments: ProcessedAttachment[] = [];\n    let transcribedText = '';\n\n    if (bot && botToken && media.length > 0) {\n      const accountApiRoot = account.apiRoot?.replace(/\\/$/, '') || 'https://api.telegram.org';\n      const mediaResult = await processAllMedia(\n        media,\n        bot,\n        botToken,\n        accountApiRoot,\n        message,\n        sttService,\n        mediaUtils,\n        config?.tools?.media?.audio,\n        voiceProbeText || undefined,\n      );\n      attachments = mediaResult.attachments;\n      transcribedText = mediaResult.transcribedText;\n    }\n\n    // Combine transcribed text with content. If the user caption is a slash command, put it first\n    // so routing and logs match a normal `/cmd` message (STT prefix no longer hides the command).\n    const captionIsCommand = cleanContent.trim().startsWith('/');\n    const finalContent = transcribedText\n      ? captionIsCommand && cleanContent\n        ? cleanContent.trim() + (transcribedText ? `\\n\\n${transcribedText}` : '')\n        : transcribedText + (cleanContent ? '\\n\\n' + cleanContent : '')\n      : cleanContent;\n\n    const isCommand = cleanContent.trim().startsWith('/');\n\n    log.info({\n      accountId,\n      chatId,\n      senderId,\n      isGroup,\n      sessionKey,\n      contentLength: finalContent.length,\n      attachmentCount: attachments.length,\n      isCommand,\n    }, 'Processing Telegram message');\n\n    if (\n      finalContent.trim().length > 0 &&\n      !isCommand &&\n      tryConsumeTelegramClarifyFreeText(sessionKey, finalContent.trim())\n    ) {\n      log.debug({ sessionKey }, 'Telegram: consumed message as clarify reply');\n      return;\n    }\n\n    await bus.publishInbound({\n      channel: 'telegram',\n      sender_id: senderId,\n      chat_id: chatId,\n      content: finalContent,\n      metadata: {\n        accountId,\n        sessionKey,\n        senderUsername,\n        messageId: String(message.message_id),\n        isGroup,\n        isCommand,\n        threadId: threadId ? String(threadId) : undefined,\n        media: media.length > 0 ? media : undefined,\n        transcribedVoice: !!transcribedText || undefined,\n      },\n      attachments: attachments.length > 0 ? attachments : undefined,\n    });\n  };\n\n  // Main enqueue function\n  return (ctx: Context, accountId: string): Promise<void> => {\n    const message = ctx.message;\n    if (message) {\n      const raw = message.text ?? message.caption ?? '';\n      if (raw.trim() && isAbortSlashCommand(raw.trim())) {\n        return processMessageInternal(ctx, accountId);\n      }\n    }\n\n    const chatId = String(ctx.chat?.id);\n    const chatKey = getChatKey(accountId, chatId);\n\n    return new Promise((resolve, reject) => {\n      const queue = messageQueues.get(chatKey) || [];\n      queue.push({ ctx, accountId, resolve, reject });\n      messageQueues.set(chatKey, queue);\n      processNextMessage(chatKey);\n    });\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"inbound-processor.js","names":[],"sources":["../../../../extensions/telegram/src/inbound-processor.ts"],"sourcesContent":["/**\n * Telegram Inbound Processor\n *\n * Handles inbound message processing from Telegram:\n * - Message queuing (per chat)\n * - Deduplication\n * - Access control\n * - Media download\n * - STT transcription\n * - Event publishing to bus\n */\n\nimport type { Bot, Context } from 'grammy';\nimport type { Message } from '@grammyjs/types';\nimport type { Config } from '@xopcai/xopc/config/schema.js';\nimport type { MessageBus } from '@xopcai/xopc/infra/bus/index.js';\nimport type { TelegramAccountManager } from './account-manager.js';\nimport { telegramUpdateDedupe, buildTelegramUpdateKey } from './dedupe.js';\nimport { createLogger } from '@xopcai/xopc/utils/logger.js';\nimport { normalizeTelegramCommandName, parseSlashCommand } from '@xopcai/xopc/chat-commands/command-parse.js';\nimport { tryConsumeTelegramClarifyFreeText } from '@xopcai/xopc/gateway/clarify-runtime.js';\nimport { resolveRoute } from '@xopcai/xopc/routing/index.js';\nimport { resolveTelegramGroupContext } from './group-config-resolver.js';\nimport { resolveTelegramFocusedSessionKey } from './focus-handler.js';\nimport { buildTelegramConversationId } from './conversation-id.js';\nimport { checkMentionInTranscription } from '@xopcai/xopc/voice/stt/index.js';\n\nconst log = createLogger('TelegramInboundProcessor');\n\n/** Must bypass the per-chat queue so /abort can cancel an in-flight turn. */\nfunction isAbortSlashCommand(text: string): boolean {\n  const parsed = parseSlashCommand(text);\n  if (!parsed) return false;\n  const cmd = normalizeTelegramCommandName(parsed.command);\n  return cmd === 'abort' || cmd === 'stop' || cmd === 'cancel';\n}\n\n/** Maximum voice message duration for STT in seconds */\nconst STT_MAX_VOICE_DURATION_SECONDS = 60;\n\n// =============================================================================\n// External Service Interfaces (for dependency injection)\n// =============================================================================\n\nexport interface AccessControlService {\n  normalizeAllowFromWithStore(options: { allowFrom?: Array<string | number> }): unknown;\n  evaluateGroupBaseAccess(options: {\n    isGroup: boolean;\n    groupConfig?: unknown;\n    topicConfig?: unknown;\n    hasGroupAllowOverride: boolean;\n    effectiveGroupAllow: unknown;\n    senderId?: string;\n    senderUsername?: string;\n  }): { allowed: boolean; reason?: string };\n  resolveRequireMention(options: {\n    topicConfig?: unknown;\n    groupConfig?: unknown;\n    defaultRequireMention?: boolean;\n  }): boolean;\n  hasBotMention(options: { botUsername: string; text?: string; entities?: unknown }): boolean;\n  removeBotMention(text: string, botUsername: string): string;\n}\n\nexport interface SessionKeyService {\n  generateSessionKey(options: {\n    source: string;\n    chatId: string;\n    senderId: string;\n    isGroup: boolean;\n    threadId?: string;\n    accountId?: string;\n    agentId?: string;\n  }): string;\n}\n\nexport interface STTService {\n  transcribe(buffer: Buffer, config: unknown, options?: { language?: string }): Promise<{ text: string }>;\n  isSTTAvailable(config: unknown): boolean;\n}\n\nexport interface MediaUtils {\n  getMimeType(type: string, filePath?: string): string;\n}\n\n// =============================================================================\n// Dependencies Interface\n// =============================================================================\n\nexport interface InboundProcessorDeps {\n  bus: MessageBus;\n  config: Config;\n  accountManager: TelegramAccountManager;\n  // External services (injected for testability)\n  accessControl: AccessControlService;\n  sessionKeyService: SessionKeyService;\n  sttService: STTService;\n  mediaUtils: MediaUtils;\n}\n\ninterface QueuedMessage {\n  ctx: Context;\n  accountId: string;\n  resolve: () => void;\n  reject: (err: Error) => void;\n}\n\n// =============================================================================\n// Media Processing Types\n// =============================================================================\n\ninterface MediaItem {\n  type: string;\n  fileId: string;\n  emoji?: string;\n}\n\ninterface ProcessedAttachment {\n  type: string;\n  mimeType: string;\n  data: string;\n  name?: string;\n  size?: number;\n}\n\n// =============================================================================\n// Helper Functions (reduce nesting in main processor)\n// =============================================================================\n\n/**\n * Extract media items from message\n */\nfunction extractMediaItems(message: Message): MediaItem[] {\n  const media: MediaItem[] = [];\n  \n  if (message.photo?.length) {\n    media.push({ type: 'photo', fileId: message.photo[message.photo.length - 1].file_id });\n  }\n  if (message.document) {\n    media.push({ type: 'document', fileId: message.document.file_id });\n  }\n  if (message.video) {\n    media.push({ type: 'video', fileId: message.video.file_id });\n  }\n  if (message.audio) {\n    media.push({ type: 'audio', fileId: message.audio.file_id });\n  }\n  if (message.voice) {\n    media.push({ type: 'voice', fileId: message.voice.file_id });\n  }\n  if (message.sticker) {\n    media.push({ type: 'sticker', fileId: message.sticker.file_id, emoji: message.sticker.emoji });\n  }\n\n  return media;\n}\n\n/**\n * Download + STT a Telegram voice message (for mention probe or media pipeline).\n */\nasync function downloadAndTranscribeTelegramVoice(params: {\n  voice: NonNullable<Message['voice']>;\n  bot: Bot;\n  botToken: string;\n  accountApiRoot: string;\n  sttService: STTService;\n  sttConfig: unknown;\n}): Promise<string> {\n  const { voice, bot, botToken, accountApiRoot, sttService, sttConfig } = params;\n  const voiceDuration = voice.duration || 0;\n  if (voiceDuration > STT_MAX_VOICE_DURATION_SECONDS) {\n    return '';\n  }\n  if (!sttService.isSTTAvailable(sttConfig)) {\n    return '';\n  }\n  try {\n    const file = await bot.api.getFile(voice.file_id);\n    const downloadUrl = `${accountApiRoot}/file/bot${botToken}/${file.file_path}`;\n    const response = await fetch(downloadUrl);\n    if (!response.ok) {\n      return '';\n    }\n    const buffer = Buffer.from(await response.arrayBuffer());\n    if (buffer.length === 0) {\n      return '';\n    }\n    const sttResult = await sttService.transcribe(buffer, sttConfig, {\n      language: (sttConfig as { provider?: string })?.provider === 'alibaba' ? 'zh' : undefined,\n    });\n    return sttResult.text?.trim() ?? '';\n  } catch {\n    return '';\n  }\n}\n\n/**\n * Process a single media item (download + optional STT)\n */\nasync function processMediaItem(\n  item: MediaItem,\n  bot: Bot,\n  botToken: string,\n  accountApiRoot: string,\n  message: Message,\n  sttService: STTService,\n  mediaUtils: MediaUtils,\n  sttConfig: unknown,\n  reuseVoiceTranscript?: string,\n): Promise<{ attachment: ProcessedAttachment | null; transcribedText: string }> {\n  try {\n    const file = await bot.api.getFile(item.fileId);\n    const downloadUrl = `${accountApiRoot}/file/bot${botToken}/${file.file_path}`;\n    const response = await fetch(downloadUrl);\n\n    // Debug log for media download\n    log.info({\n      type: item.type,\n      fileId: item.fileId,\n      downloadUrl,\n      responseStatus: response.status,\n    }, 'Media download response');\n\n    if (!response.ok) {\n      throw new Error(`Failed to download: ${response.status}`);\n    }\n\n    const buffer = await response.arrayBuffer();\n\n    // Debug log for buffer size\n    log.info({\n      type: item.type,\n      fileId: item.fileId,\n      bufferSize: buffer.byteLength,\n      filePath: file.file_path,\n    }, 'Media buffer downloaded');\n\n    if (buffer.byteLength === 0) {\n      log.warn({\n        type: item.type,\n        fileId: item.fileId,\n        filePath: file.file_path,\n      }, 'Media buffer is empty, may cause issues');\n    }\n    let transcribedText = '';\n\n    // Handle voice messages with STT\n    if (item.type === 'voice' && sttService.isSTTAvailable(sttConfig)) {\n      if (reuseVoiceTranscript !== undefined && reuseVoiceTranscript !== '') {\n        transcribedText = reuseVoiceTranscript;\n      } else {\n        const voiceDuration = message.voice?.duration || 0;\n        if (voiceDuration <= STT_MAX_VOICE_DURATION_SECONDS) {\n          try {\n            const sttResult = await sttService.transcribe(Buffer.from(buffer), sttConfig, {\n              language: (sttConfig as { provider?: string })?.provider === 'alibaba' ? 'zh' : undefined,\n            });\n            transcribedText = sttResult.text;\n          } catch (sttError) {\n            log.error({ sttError }, 'STT transcription failed');\n            transcribedText = '[STT failed]';\n          }\n        } else {\n          transcribedText = `[Voice message too long (>${STT_MAX_VOICE_DURATION_SECONDS}s)]`;\n        }\n      }\n    }\n\n    const base64 = Buffer.from(buffer).toString('base64');\n    const mimeType = mediaUtils.getMimeType(item.type, file.file_path);\n\n    // Debug log for attachment creation\n    log.info({\n      type: item.type,\n      mimeType,\n      base64Length: base64.length,\n      size: buffer.byteLength,\n      name: file.file_path?.split('/').pop(),\n    }, 'Attachment created');\n\n    return {\n      attachment: {\n        type: item.type,\n        mimeType,\n        data: base64,\n        name: file.file_path?.split('/').pop(),\n        size: buffer.byteLength,\n      },\n      transcribedText,\n    };\n  } catch (err) {\n    log.error({ type: item.type, fileId: item.fileId, err }, 'Failed to download media');\n    return { attachment: null, transcribedText: '' };\n  }\n}\n\n/**\n * Process all media items\n */\nasync function processAllMedia(\n  media: MediaItem[],\n  bot: Bot,\n  botToken: string,\n  accountApiRoot: string,\n  message: Message,\n  sttService: STTService,\n  mediaUtils: MediaUtils,\n  sttConfig: unknown,\n  reuseVoiceTranscript?: string,\n): Promise<{ attachments: ProcessedAttachment[]; transcribedText: string }> {\n  const attachments: ProcessedAttachment[] = [];\n  let transcribedText = '';\n  let voiceReuseConsumed = false;\n\n  for (const item of media) {\n    const reuse =\n      item.type === 'voice' && reuseVoiceTranscript && !voiceReuseConsumed\n        ? reuseVoiceTranscript\n        : undefined;\n    if (reuse) {\n      voiceReuseConsumed = true;\n    }\n    const result = await processMediaItem(\n      item,\n      bot,\n      botToken,\n      accountApiRoot,\n      message,\n      sttService,\n      mediaUtils,\n      sttConfig,\n      reuse,\n    );\n    \n    if (result.attachment) {\n      attachments.push(result.attachment);\n    }\n    if (result.transcribedText) {\n      transcribedText = result.transcribedText;\n    }\n  }\n\n  return { attachments, transcribedText };\n}\n\n// =============================================================================\n// Main Processor Factory\n// =============================================================================\n\n/**\n * Create inbound message processor\n */\nexport function createInboundProcessor(deps: InboundProcessorDeps) {\n  const {\n    bus,\n    config,\n    accountManager,\n    accessControl,\n    sessionKeyService,\n    sttService,\n    mediaUtils,\n  } = deps;\n\n  const messageQueues = new Map<string, QueuedMessage[]>();\n  const processingLocks = new Map<string, Promise<void>>();\n\n  const getChatKey = (accountId: string, chatId: string): string => `${accountId}:${chatId}`;\n\n  const processNextMessage = async (chatKey: string): Promise<void> => {\n    if (processingLocks.has(chatKey)) return;\n\n    const queue = messageQueues.get(chatKey);\n    if (!queue || queue.length === 0) return;\n\n    let lockResolve: () => void;\n    const lockPromise = new Promise<void>((resolve) => {\n      lockResolve = resolve;\n    });\n    processingLocks.set(chatKey, lockPromise);\n\n    const { ctx, accountId, resolve, reject } = queue.shift()!;\n\n    try {\n      await processMessageInternal(ctx, accountId);\n      resolve();\n    } catch (err) {\n      reject(err instanceof Error ? err : new Error(String(err)));\n    } finally {\n      lockResolve?.();\n      processingLocks.delete(chatKey);\n      if (queue.length > 0) {\n        processNextMessage(chatKey);\n      } else {\n        messageQueues.delete(chatKey);\n      }\n    }\n  };\n\n  const processMessageInternal = async (ctx: Context, accountId: string) => {\n    // Deduplication check\n    const updateKey = buildTelegramUpdateKey(ctx);\n    if (updateKey && telegramUpdateDedupe.checkAndAdd(updateKey)) {\n      log.debug({ updateKey, accountId }, 'Duplicate update detected, skipping');\n      return;\n    }\n\n    const account = accountManager.getAccount(accountId);\n    if (!account) {\n      log.warn({ accountId }, 'Account not found for message processing');\n      return;\n    }\n\n    const botUsername = accountManager.getBotUsername(accountId);\n    if (!botUsername) {\n      log.warn({ accountId }, 'Bot username not available');\n      return;\n    }\n\n    const message = ctx.message ?? ctx.channelPost;\n    if (!message) return;\n\n    const chatId = String(ctx.chat?.id);\n    const senderId = String(ctx.from?.id);\n    const senderUsername = ctx.from?.username;\n    const content = message.text ?? message.caption ?? '';\n    const isGroup = ctx.chat?.type === 'group' || ctx.chat?.type === 'supergroup';\n    const threadId = (message as { message_thread_id?: number }).message_thread_id;\n\n    // Access control (group/topic allowlists, mention gating)\n    const effectiveAllowFrom = accessControl.normalizeAllowFromWithStore({\n      allowFrom: isGroup ? account.groupAllowFrom : account.allowFrom,\n    });\n\n    const baseAccess = accessControl.evaluateGroupBaseAccess({\n      isGroup,\n      groupConfig: account.groups?.[chatId],\n      topicConfig: threadId ? account.groups?.[chatId]?.topics?.[String(threadId)] : undefined,\n      hasGroupAllowOverride: !!(account.groups?.[chatId]?.allowFrom ||\n        (threadId && account.groups?.[chatId]?.topics?.[String(threadId)]?.allowFrom)),\n      effectiveGroupAllow: effectiveAllowFrom,\n      senderId,\n      senderUsername,\n    });\n\n    if (!baseAccess.allowed) {\n      log.debug({ accountId, chatId, reason: baseAccess.reason }, 'Message blocked by base access');\n      return;\n    }\n\n    const botEarly = accountManager.getBot(accountId);\n    const botTokenEarly = account.botToken;\n    const accountApiRootEarly = account.apiRoot?.replace(/\\/$/, '') || 'https://api.telegram.org';\n\n    let voiceProbeText = '';\n    if (\n      isGroup &&\n      message.voice &&\n      botEarly &&\n      botTokenEarly &&\n      sttService.isSTTAvailable(config?.tools?.media?.audio)\n    ) {\n      voiceProbeText = await downloadAndTranscribeTelegramVoice({\n        voice: message.voice,\n        bot: botEarly,\n        botToken: botTokenEarly,\n        accountApiRoot: accountApiRootEarly,\n        sttService,\n        sttConfig: config?.tools?.media?.audio,\n      });\n    }\n\n    if (isGroup) {\n      const requireMention = accessControl.resolveRequireMention({\n        topicConfig: threadId ? account.groups?.[chatId]?.topics?.[String(threadId)] : undefined,\n        groupConfig: account.groups?.[chatId],\n        defaultRequireMention: true,\n      });\n\n      const hasMedia = !!(message.photo || message.document || message.video || message.audio || message.voice);\n      const captionEntities = (message as any).caption_entities;\n      const voiceMention = voiceProbeText.trim();\n      const hasMention =\n        accessControl.hasBotMention({ botUsername, text: content, entities: message.entities }) ||\n        (hasMedia &&\n          accessControl.hasBotMention({\n            botUsername,\n            text: message.caption ?? '',\n            entities: captionEntities,\n          })) ||\n        (voiceMention.length > 0 &&\n          (accessControl.hasBotMention({ botUsername, text: voiceMention }) ||\n            checkMentionInTranscription(voiceMention, [botUsername])));\n\n      if (requireMention && !hasMention) {\n        const isVoiceOnly =\n          !!message.voice &&\n          !message.photo &&\n          !message.document &&\n          !message.video &&\n          !message.audio &&\n          !(message.caption ?? '').trim() &&\n          !content.trim();\n\n        if (isVoiceOnly) {\n          log.debug({ accountId, chatId }, 'Group voice without mention after STT probe, ignored');\n          return;\n        }\n\n        if (!hasMedia || content.trim().length > 0) {\n          log.debug({ accountId, chatId }, 'Group message without mention ignored');\n          return;\n        }\n        log.debug({ accountId, chatId }, 'Group media message without mention - processing anyway');\n      }\n    }\n\n    const cleanContent = isGroup ? accessControl.removeBotMention(content, botUsername) : content;\n\n    const groupCtx = resolveTelegramGroupContext({ account, chatId, threadId });\n    const route = resolveRoute({\n      config,\n      channel: 'telegram',\n      accountId,\n      peerKind: isGroup ? 'group' : 'dm',\n      peerId: isGroup ? chatId : senderId,\n      threadId: threadId ? String(threadId) : null,\n    });\n    const routedAgentId = groupCtx.agentId ?? route.agentId;\n\n    const defaultSessionKey = sessionKeyService.generateSessionKey({\n      source: 'telegram',\n      chatId,\n      senderId,\n      isGroup,\n      threadId: threadId ? String(threadId) : undefined,\n      accountId,\n      agentId: routedAgentId,\n    });\n\n    const sessionKey = resolveTelegramFocusedSessionKey({\n      chatId,\n      threadId: threadId ? String(threadId) : undefined,\n      defaultSessionKey,\n    });\n\n    const conversationId = buildTelegramConversationId(chatId, threadId);\n\n    // Collect and process media\n    const media = extractMediaItems(message);\n    const bot = accountManager.getBot(accountId);\n    const botToken = account.botToken;\n\n    let attachments: ProcessedAttachment[] = [];\n    let transcribedText = '';\n\n    if (bot && botToken && media.length > 0) {\n      const accountApiRoot = account.apiRoot?.replace(/\\/$/, '') || 'https://api.telegram.org';\n      const mediaResult = await processAllMedia(\n        media,\n        bot,\n        botToken,\n        accountApiRoot,\n        message,\n        sttService,\n        mediaUtils,\n        config?.tools?.media?.audio,\n        voiceProbeText || undefined,\n      );\n      attachments = mediaResult.attachments;\n      transcribedText = mediaResult.transcribedText;\n    }\n\n    // Combine transcribed text with content. If the user caption is a slash command, put it first\n    // so routing and logs match a normal `/cmd` message (STT prefix no longer hides the command).\n    const captionIsCommand = cleanContent.trim().startsWith('/');\n    let finalContent = transcribedText\n      ? captionIsCommand && cleanContent\n        ? cleanContent.trim() + (transcribedText ? `\\n\\n${transcribedText}` : '')\n        : transcribedText + (cleanContent ? '\\n\\n' + cleanContent : '')\n      : cleanContent;\n\n    const stickerItem = media.find((m) => m.type === 'sticker');\n    if (stickerItem && !finalContent.trim()) {\n      finalContent = stickerItem.emoji?.trim()\n        ? `[Sticker ${stickerItem.emoji}]`\n        : '[Sticker]';\n    }\n\n    const isCommand = cleanContent.trim().startsWith('/');\n\n    log.info({\n      accountId,\n      chatId,\n      senderId,\n      isGroup,\n      sessionKey,\n      contentLength: finalContent.length,\n      attachmentCount: attachments.length,\n      isCommand,\n    }, 'Processing Telegram message');\n\n    if (\n      finalContent.trim().length > 0 &&\n      !isCommand &&\n      tryConsumeTelegramClarifyFreeText(sessionKey, finalContent.trim())\n    ) {\n      log.debug({ sessionKey }, 'Telegram: consumed message as clarify reply');\n      return;\n    }\n\n    await bus.publishInbound({\n      channel: 'telegram',\n      sender_id: senderId,\n      chat_id: chatId,\n      content: finalContent,\n      metadata: {\n        accountId,\n        sessionKey,\n        senderUsername,\n        messageId: String(message.message_id),\n        isGroup,\n        isCommand,\n        threadId: threadId ? String(threadId) : undefined,\n        conversationId,\n        channelSystemPrompt: groupCtx.systemPrompt,\n        channelAgentId: routedAgentId,\n        media: media.length > 0 ? media : undefined,\n        transcribedVoice: !!transcribedText || undefined,\n      },\n      attachments: attachments.length > 0 ? attachments : undefined,\n    });\n  };\n\n  // Main enqueue function\n  return (ctx: Context, accountId: string): Promise<void> => {\n    const message = ctx.message;\n    if (message) {\n      const raw = message.text ?? message.caption ?? '';\n      if (raw.trim() && isAbortSlashCommand(raw.trim())) {\n        return processMessageInternal(ctx, accountId);\n      }\n    }\n\n    const chatId = String(ctx.chat?.id);\n    const chatKey = getChatKey(accountId, chatId);\n\n    return new Promise((resolve, reject) => {\n      const queue = messageQueues.get(chatKey) || [];\n      queue.push({ ctx, accountId, resolve, reject });\n      messageQueues.set(chatKey, queue);\n      processNextMessage(chatKey);\n    });\n  };\n}\n"],"mappings":"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"}

package/dist/extensions/telegram/src/network-errors.d.ts

@@ -0,0 +1,2 @@
+export declare function isRecoverableTelegramNetworkError(err: unknown): boolean;
+export declare function isTelegramClientRejection(err: unknown): boolean;

package/dist/extensions/telegram/src/network-errors.js

@@ -0,0 +1,23 @@
+//#region extensions/telegram/src/network-errors.ts
+const RECOVERABLE_NETWORK_RE = /ETIMEDOUT|ENETUNREACH|EHOSTUNREACH|ECONNRESET|ECONNREFUSED|ENOTFOUND|EAI_AGAIN|socket hang up|fetch failed|network/i;
+function isRecoverableTelegramNetworkError(err) {
+	const text = extractErrorText(err);
+	return RECOVERABLE_NETWORK_RE.test(text);
+}
+function isTelegramClientRejection(err) {
+	const text = extractErrorText(err);
+	return /400:|403:|429:|Bad Request|Forbidden|Too Many Requests/i.test(text);
+}
+function extractErrorText(err) {
+	if (typeof err === "string") return err;
+	if (err instanceof Error) return err.message;
+	if (err && typeof err === "object" && "description" in err) {
+		const d = err.description;
+		return typeof d === "string" ? d : "";
+	}
+	return String(err);
+}
+//#endregion
+export { isRecoverableTelegramNetworkError, isTelegramClientRejection };
+
+//# sourceMappingURL=network-errors.js.map

package/dist/extensions/telegram/src/network-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-errors.js","names":[],"sources":["../../../../extensions/telegram/src/network-errors.ts"],"sourcesContent":["const RECOVERABLE_NETWORK_RE =\n  /ETIMEDOUT|ENETUNREACH|EHOSTUNREACH|ECONNRESET|ECONNREFUSED|ENOTFOUND|EAI_AGAIN|socket hang up|fetch failed|network/i;\n\nexport function isRecoverableTelegramNetworkError(err: unknown): boolean {\n  const text = extractErrorText(err);\n  return RECOVERABLE_NETWORK_RE.test(text);\n}\n\nexport function isTelegramClientRejection(err: unknown): boolean {\n  const text = extractErrorText(err);\n  return /400:|403:|429:|Bad Request|Forbidden|Too Many Requests/i.test(text);\n}\n\nfunction extractErrorText(err: unknown): string {\n  if (typeof err === 'string') return err;\n  if (err instanceof Error) return err.message;\n  if (err && typeof err === 'object' && 'description' in err) {\n    const d = (err as { description?: unknown }).description;\n    return typeof d === 'string' ? d : '';\n  }\n  return String(err);\n}\n"],"mappings":";AAAA,MAAM,yBACJ;AAEF,SAAgB,kCAAkC,KAAuB;CACvE,MAAM,OAAO,iBAAiB,IAAI;AAClC,QAAO,uBAAuB,KAAK,KAAK;;AAG1C,SAAgB,0BAA0B,KAAuB;CAC/D,MAAM,OAAO,iBAAiB,IAAI;AAClC,QAAO,0DAA0D,KAAK,KAAK;;AAG7E,SAAS,iBAAiB,KAAsB;AAC9C,KAAI,OAAO,QAAQ,SAAU,QAAO;AACpC,KAAI,eAAe,MAAO,QAAO,IAAI;AACrC,KAAI,OAAO,OAAO,QAAQ,YAAY,iBAAiB,KAAK;EAC1D,MAAM,IAAK,IAAkC;AAC7C,SAAO,OAAO,MAAM,WAAW,IAAI;;AAErC,QAAO,OAAO,IAAI"}

package/dist/extensions/telegram/src/plugin.d.ts

@@ -8,6 +8,7 @@ import type { Config } from '@xopcai/xopc/config/index.js';
 import type { ChannelPlugin, ChannelPluginDefaults, ChannelPluginInitOptions, ChannelPluginReloadMeta, ChannelPluginStartOptions, ChannelOutboundAdapter, ChannelGatewayAdapter, ChannelStreamingAdapter, ChannelCommandAdapter } from '@xopcai/xopc/channels/plugin-types.js';
 import type { TelegramResolvedAccount } from './adapters/index.js';
 import type { ChannelCronDeliveryAdapter } from '@xopcai/xopc/channels/plugins/types.adapters.js';
+import { handleTelegramChannelAction } from './actions/message-actions.js';
 export type { TelegramResolvedAccount as TelegramAccount } from './channel.js';
 export declare class TelegramChannelPlugin implements ChannelPlugin<TelegramResolvedAccount> {
     readonly id: "telegram";
@@ -37,6 +38,11 @@ export declare class TelegramChannelPlugin implements ChannelPlugin<TelegramReso
     readonly cronDelivery: ChannelCronDeliveryAdapter;
     readonly configSurface: import("@xopcai/xopc/channels/plugins/types.adapters.js").ChannelConfigSurfaceAdapter;
     readonly onboard: import("@xopcai/xopc/channels/plugins/types.adapters.js").ChannelOnboardAdapter;
+    readonly doctor: {
+        check: (params: {
+            cfg: Config;
+        }) => Promise<import("@xopcai/xopc/channels/plugin-types.js").ChannelDoctorCheckResult[]>;
+    };
     readonly pairing: import("@xopcai/xopc/channels/plugins/types.adapters.js").ChannelPairingAdapter;
     private bus;
     private cfg;
@@ -48,6 +54,11 @@ export declare class TelegramChannelPlugin implements ChannelPlugin<TelegramReso
     private sessionModelHooks?;
     /** Unregister fn for the workflow-progress capability registered against the global broker. */
     private workflowProgressUnregister;
+    private inboundCoalescer;
+    private execApprovalUnregister;
+    readonly actions: {
+        handleAction: typeof handleTelegramChannelAction;
+    };
     config: import('@xopcai/xopc/channels/plugin-types.js').ChannelConfigAdapter<TelegramResolvedAccount>;
     security: import('@xopcai/xopc/channels/plugin-types.js').ChannelSecurityAdapter<TelegramResolvedAccount>;
     status: import('@xopcai/xopc/channels/plugin-types.js').ChannelStatusAdapter<TelegramResolvedAccount>;