@ebowwa/daemons 0.5.0

package/src/channels/telegram.ts

@@ -0,0 +1,315 @@
+/**
+ * Telegram Channel for GLM Daemon
+ *
+ * Wraps @ebowwa/channel-telegram (pure protocol adapter)
+ * with GLM Daemon intelligence (GLM client, daemon delegation, routing).
+ */
+
+import {
+  type ChannelId,
+  type ChannelCapabilities,
+} from "@ebowwa/channel-types";
+import {
+  TelegramChannel as TelegramProtocolAdapter,
+  type TelegramConfig as ProtocolConfig,
+  // Telegram target normalization utilities
+  normalizeTelegramMessagingTarget,
+  looksLikeTelegramTargetId,
+  extractRawTarget,
+  isUsernameTarget,
+  isNumericIdTarget,
+} from "@ebowwa/channel-telegram";
+import {
+  BaseChannel,
+  type GLMChannelConfig,
+} from "./base.js";
+
+// Re-export normalization utilities for consumers
+export {
+  normalizeTelegramMessagingTarget,
+  looksLikeTelegramTargetId,
+  extractRawTarget,
+  isUsernameTarget,
+  isNumericIdTarget,
+};
+
+// ============================================================
+// TELEGRAM CHANNEL CONFIG
+// ============================================================
+
+export interface TelegramChannelConfig extends GLMChannelConfig {
+  platform: "telegram";
+  /** Bot token from @BotFather */
+  botToken: string;
+  /** Test chat ID for startup notification */
+  testChatId?: string;
+  /** Allowed user IDs (empty = all) */
+  allowedUsers?: number[];
+  /** Allowed chat IDs (empty = all) */
+  allowedChats?: number[];
+}
+
+// Legacy type alias for backwards compat
+export type { TelegramChannelConfig as TelegramConfig };
+
+// ============================================================
+// TELEGRAM CHANNEL (Wraps @ebowwa/channel-telegram)
+// ============================================================
+
+export class GLMTelegramChannel extends BaseChannel {
+  readonly id: ChannelId;
+  readonly label = "Telegram";
+  readonly capabilities: ChannelCapabilities = {
+    supports: {
+      text: true,
+      media: true,
+      replies: true,
+      threads: false,
+      reactions: true,
+      editing: true,
+      streaming: false,
+    },
+    media: {
+      maxFileSize: 50 * 1024 * 1024, // 50MB
+      supportedMimeTypes: ["image/*", "video/*", "audio/*", "application/pdf"],
+    },
+    rateLimits: {
+      messagesPerMinute: 30,
+      charactersPerMessage: 4096,
+    },
+  };
+
+  private protocolAdapter: TelegramProtocolAdapter;
+  private telegramConfig: {
+    botToken: string;
+    testChatId?: string;
+    allowedUsers?: number[];
+    allowedChats?: number[];
+  };
+
+  constructor(config: TelegramChannelConfig) {
+    super(config);
+
+    this.telegramConfig = {
+      botToken: config.botToken,
+      testChatId: config.testChatId,
+      allowedUsers: config.allowedUsers,
+      allowedChats: config.allowedChats,
+    };
+
+    this.id = this.createId();
+    this.protocolAdapter = new TelegramProtocolAdapter(this.telegramConfig);
+  }
+
+  // ============================================================
+  // ChannelConnector Implementation
+  // ============================================================
+
+  /**
+   * Send response to Telegram via protocol adapter
+   */
+  async send(response: Parameters<TelegramProtocolAdapter['send']>[0]): Promise<void> {
+    await this.protocolAdapter.send(response);
+  }
+
+  // ============================================================
+  // Platform-Specific Implementation (BaseChannel abstract methods)
+  // ============================================================
+
+  /**
+   * Start Telegram bot via protocol adapter
+   */
+  protected async startPlatform(): Promise<void> {
+    console.log("[TelegramChannel] Starting via protocol adapter...");
+
+    // Connect protocol adapter to our routing logic
+    this.protocolAdapter.onMessage(async (message) => {
+      // Route through BaseChannel's routing logic (GLM + daemon)
+      return this.routeChannelMessage(message);
+    });
+
+    await this.protocolAdapter.start();
+    console.log("[TelegramChannel] Protocol adapter started");
+  }
+
+  /**
+   * Stop Telegram bot via protocol adapter
+   */
+  protected async stopPlatform(): Promise<void> {
+    console.log("[TelegramChannel] Stopping protocol adapter...");
+    await this.protocolAdapter.stop();
+  }
+
+  // ============================================================
+  // Telegram-Specific Helpers (delegated to protocol adapter)
+  // ============================================================
+
+  /**
+   * Get underlying bot instance for advanced operations
+   */
+  getBot() {
+    return this.protocolAdapter.getBot();
+  }
+
+  /**
+   * Send a simple message
+   */
+  async sendMessage(chatId: number, text: string) {
+    await this.protocolAdapter.sendMessage(chatId, text);
+  }
+
+  /**
+   * Start typing indicator
+   */
+  startTypingIndicator(chatId: number) {
+    this.protocolAdapter.startTypingIndicator(chatId);
+  }
+
+  /**
+   * Stop typing indicator
+   */
+  stopTypingIndicator(chatId: number) {
+    this.protocolAdapter.stopTypingIndicator(chatId);
+  }
+
+  /**
+   * Check if user/chat is allowed
+   */
+  isAllowed(userId?: number, chatId?: number): boolean {
+    return this.protocolAdapter.isAllowed(userId, chatId);
+  }
+
+  // ============================================================
+  // Target Normalization Helpers
+  // ============================================================
+
+  /**
+   * Normalize a Telegram target (username, URL, or ID) to standard format.
+   *
+   * @param raw - Raw input (@username, t.me/user, 123456, etc.)
+   * @returns Normalized target or undefined if invalid
+   *
+   * @example
+   * channel.normalizeTarget("@durov")      // "telegram:@durov"
+   * channel.normalizeTarget("t.me/durov")  // "telegram:@durov"
+   * channel.normalizeTarget("123456")      // "telegram:123456"
+   */
+  normalizeTarget(raw: string): string | undefined {
+    return normalizeTelegramMessagingTarget(raw);
+  }
+
+  /**
+   * Check if a string looks like a Telegram target.
+   *
+   * @param raw - Raw input string
+   * @returns true if it looks like a Telegram target
+   */
+  isValidTarget(raw: string): boolean {
+    return looksLikeTelegramTargetId(raw);
+  }
+
+  /**
+   * Parse a target from user input and extract the usable form.
+   *
+   * @param input - User input like "send to @user" or "dm t.me/user"
+   * @returns Extracted raw target (@username or numeric ID) or undefined
+   *
+   * @example
+   * channel.parseTargetFromInput("send to @durov")  // "@durov"
+   * channel.parseTargetFromInput("dm 123456")       // "123456"
+   */
+  parseTargetFromInput(input: string): string | undefined {
+    const words = input.split(/\s+/);
+    for (const word of words) {
+      if (looksLikeTelegramTargetId(word)) {
+        const normalized = normalizeTelegramMessagingTarget(word);
+        if (normalized) {
+          return extractRawTarget(normalized);
+        }
+      }
+    }
+    return undefined;
+  }
+
+  /**
+   * Send a message to a target (username or chat ID).
+   *
+   * @param target - Telegram target (@username, numeric ID, or normalized format)
+   * @param text - Message text
+   *
+   * @example
+   * await channel.sendToTarget("@durov", "Hello!")
+   * await channel.sendToTarget("123456", "Hello!")
+   */
+  async sendToTarget(target: string, text: string): Promise<void> {
+    const normalized = normalizeTelegramMessagingTarget(target);
+    if (!normalized) {
+      throw new Error(`Invalid Telegram target: ${target}`);
+    }
+
+    const rawTarget = extractRawTarget(normalized);
+    if (!rawTarget) {
+      throw new Error(`Failed to extract target from: ${normalized}`);
+    }
+
+    // Parse chat ID (numeric or resolve username)
+    let chatId: number;
+
+    if (isNumericIdTarget(normalized)) {
+      chatId = parseInt(rawTarget, 10);
+    } else {
+      // Username target - need to resolve via bot API
+      // Note: This requires the bot to have seen the user/channel before
+      // For now, we'll try direct message with username (may fail if not cached)
+      throw new Error(
+        `Username targets require resolution. Use numeric chat ID instead, or implement username resolution. Target: ${rawTarget}`
+      );
+    }
+
+    await this.sendMessage(chatId, text);
+  }
+}
+
+// ============================================================
+// FACTORY FUNCTION
+// ============================================================
+
+/**
+ * Create a Telegram channel from config
+ */
+export function createTelegramChannel(config: TelegramChannelConfig): GLMTelegramChannel {
+  return new GLMTelegramChannel(config);
+}
+
+/**
+ * Create Telegram channel config from environment (Doppler)
+ */
+export function createTelegramConfigFromEnv(): TelegramChannelConfig | null {
+  const token = process.env.TELEGRAM_BOT_TOKEN;
+  if (!token) return null;
+
+  const allowedUsers = process.env.TELEGRAM_ALLOWED_USERS
+    ?.split(",")
+    .map((s) => parseInt(s.trim(), 10))
+    .filter((n) => !isNaN(n));
+
+  const allowedChats = process.env.TELEGRAM_ALLOWED_CHATS
+    ?.split(",")
+    .map((s) => parseInt(s.trim(), 10))
+    .filter((n) => !isNaN(n));
+
+  return {
+    platform: "telegram",
+    accountId: process.env.TELEGRAM_ACCOUNT_ID || "default",
+    instanceId: process.env.TELEGRAM_INSTANCE_ID,
+    botToken: token,
+    testChatId: process.env.TELEGRAM_TEST_CHAT_ID,
+    allowedUsers,
+    allowedChats,
+    daemonWorkdir: process.env.DAEMON_WORKDIR,
+    daemonBaseBranch: process.env.DAEMON_BASE_BRANCH,
+    enableDaemonAutoPR: process.env.DAEMON_AUTO_PR === "true",
+    enableDaemonAutoCommit: process.env.DAEMON_AUTO_COMMIT === "true",
+    butlerStorageDir: process.env.BUTLER_STORAGE_DIR,
+  };
+}