feat(telegram): add topic name support for forum topics

- Add 'name' field to TelegramTopicConfig for human-readable topic names
- Update buildGroupLabel to display topic name instead of just ID when configured
- Add TopicName field to MsgContext for agent visibility
- Update Zod schema for config validation

This allows users to configure meaningful names for Telegram forum topics:

channels:
  telegram:
    groups:
      "-1234567890":
        topics:
          "37":
            name: "General Discussion"

The agent will now see 'topic:General Discussion' instead of 'topic:37' in the
conversation context.

src/auto-reply/templating.ts

@@ -103,6 +103,8 @@ export type MsgContext = {
   CommandTargetSessionKey?: string;
   /** Thread identifier (Telegram topic id or Matrix thread event id). */
   MessageThreadId?: string | number;
+  /** Topic name from config (Telegram forum topics). */
+  TopicName?: string;
   /** Telegram forum supergroup marker. */
   IsForum?: boolean;
   /**

src/config/types.telegram.ts

@@ -133,6 +133,8 @@ export type TelegramAccountConfig = {
 };
 
 export type TelegramTopicConfig = {
+  /** Human-readable name for this topic (displayed in conversation context). */
+  name?: string;
   requireMention?: boolean;
   /** If specified, only load these skills for this topic. Omit = all skills; empty = no skills. */
   skills?: string[];

src/config/zod-schema.providers-core.ts

@@ -37,6 +37,7 @@ const TelegramCapabilitiesSchema = z.union([
 
 export const TelegramTopicSchema = z
   .object({
+    name: z.string().optional(),
     requireMention: z.boolean().optional(),
     skills: z.array(z.string()).optional(),
     enabled: z.boolean().optional(),

src/telegram/bot-message-context.ts

@@ -495,7 +495,9 @@ export const buildTelegramMessageContext = async ({
         forwardOrigin.date ? ` at ${new Date(forwardOrigin.date * 1000).toISOString()}` : ""
       }]\n`
     : "";
-  const groupLabel = isGroup ? buildGroupLabel(msg, chatId, resolvedThreadId) : undefined;
+  const groupLabel = isGroup
+    ? buildGroupLabel(msg, chatId, resolvedThreadId, topicConfig?.name)
+    : undefined;
   const senderName = buildSenderName(msg);
   const conversationLabel = isGroup
     ? (groupLabel ?? `group:${chatId}`)
@@ -605,6 +607,8 @@ export const buildTelegramMessageContext = async ({
     CommandAuthorized: commandAuthorized,
     // For groups: use resolvedThreadId (forum topics only); for DMs: use raw messageThreadId
     MessageThreadId: isGroup ? resolvedThreadId : messageThreadId,
+    // Topic name from config (if configured)
+    TopicName: isGroup && resolvedThreadId != null ? topicConfig?.name : undefined,
     IsForum: isForum,
     // Originating channel for reply routing.
     OriginatingChannel: "telegram" as const,

src/telegram/bot/helpers.ts

@@ -106,9 +106,16 @@ export function buildGroupLabel(
   msg: TelegramMessage,
   chatId: number | string,
   messageThreadId?: number,
+  topicName?: string,
 ) {
   const title = msg.chat?.title;
-  const topicSuffix = messageThreadId != null ? ` topic:${messageThreadId}` : "";
+  // Include topic name if available, otherwise just show topic ID
+  const topicSuffix =
+    messageThreadId != null
+      ? topicName
+        ? ` topic:${topicName}`
+        : ` topic:${messageThreadId}`
+      : "";
   if (title) return `${title} id:${chatId}${topicSuffix}`;
   return `group:${chatId}${topicSuffix}`;
 }