feat(telegram): add editForumTopic support for thread-edit action

- Add editForumTopicTelegram() to telegram/send.ts
- Add editForumTopic action handler in telegram-actions.ts
- Register thread-edit action in telegram message plugin
- Add editForumTopic to TelegramActionConfig type
- Add thread-edit to CHANNEL_MESSAGE_ACTION_NAMES

Allows agents to rename forum topics and update custom emoji icons via:
message({ action: 'thread-edit', channel: 'telegram', target: '<chatId>', threadId: <threadId>, threadName: 'New Name' })
This commit is contained in:
Tyler Diaz 2026-01-28 13:42:20 -08:00
parent d68139a8b2
commit 26f51b8307
6 changed files with 140 additions and 0 deletions

View File

@ -4,6 +4,7 @@ import { resolveTelegramReactionLevel } from "../../telegram/reaction-level.js";
import {
createForumTopicTelegram,
deleteMessageTelegram,
editForumTopicTelegram,
editMessageTelegram,
reactMessageTelegram,
sendMessageTelegram,
@ -352,5 +353,38 @@ export async function handleTelegramAction(
});
}
if (action === "editForumTopic") {
if (!isActionEnabled("editForumTopic", false)) {
throw new Error(
"Telegram editForumTopic is disabled. Set channels.telegram.actions.editForumTopic to true.",
);
}
const chatId = readStringOrNumberParam(params, "chatId", {
required: true,
});
const messageThreadId = readNumberParam(params, "messageThreadId", {
required: true,
integer: true,
});
const name = readStringParam(params, "name");
const iconCustomEmojiId = readStringParam(params, "iconCustomEmojiId");
if (!name && !iconCustomEmojiId) {
throw new Error("At least one of name or iconCustomEmojiId is required");
}
const token = resolveTelegramToken(cfg, { accountId }).token;
if (!token) {
throw new Error(
"Telegram bot token missing. Set TELEGRAM_BOT_TOKEN or channels.telegram.botToken.",
);
}
await editForumTopicTelegram(chatId ?? "", messageThreadId ?? 0, {
token,
accountId: accountId ?? undefined,
name: name ?? undefined,
iconCustomEmojiId: iconCustomEmojiId ?? undefined,
});
return jsonResult({ ok: true });
}
throw new Error(`Unsupported Telegram action: ${action}`);
}

View File

@ -55,6 +55,9 @@ export const telegramMessageActions: ChannelMessageActionAdapter = {
if (gate("createForumTopic", false)) {
actions.add("thread-create");
}
if (gate("editForumTopic", false)) {
actions.add("thread-edit");
}
return Array.from(actions);
},
supportsButtons: ({ cfg }) => {
@ -204,6 +207,31 @@ export const telegramMessageActions: ChannelMessageActionAdapter = {
);
}
if (action === "thread-edit") {
const chatId =
readStringOrNumberParam(params, "chatId") ??
readStringOrNumberParam(params, "channelId") ??
readStringParam(params, "target") ??
readStringParam(params, "to", { required: true });
const messageThreadId = readNumberParam(params, "threadId", {
required: true,
integer: true,
});
const name = readStringParam(params, "threadName");
const iconCustomEmojiId = readStringParam(params, "iconCustomEmojiId");
return await handleTelegramAction(
{
action: "editForumTopic",
chatId,
messageThreadId,
name: name ?? undefined,
iconCustomEmojiId: iconCustomEmojiId ?? undefined,
accountId: accountId ?? undefined,
},
cfg,
);
}
throw new Error(`Action ${action} is not supported for provider ${providerId}.`);
},
};

View File

@ -21,6 +21,7 @@ export const CHANNEL_MESSAGE_ACTION_NAMES = [
"list-pins",
"permissions",
"thread-create",
"thread-edit",
"thread-list",
"thread-reply",
"search",

View File

@ -20,6 +20,8 @@ export type TelegramActionConfig = {
sticker?: boolean;
/** Enable creating forum topics in supergroups. */
createForumTopic?: boolean;
/** Enable editing forum topics in supergroups. */
editForumTopic?: boolean;
};
export type TelegramNetworkConfig = {

View File

@ -26,6 +26,7 @@ export const MESSAGE_ACTION_TARGET_MODE: Record<ChannelMessageActionName, Messag
"list-pins": "to",
permissions: "to",
"thread-create": "to",
"thread-edit": "to",
"thread-list": "none",
"thread-reply": "to",
search: "none",

View File

@ -637,6 +637,80 @@ export type CreateForumTopicResult = {
iconCustomEmojiId?: string;
};
type EditForumTopicOpts = {
token?: string;
accountId?: string;
verbose?: boolean;
api?: Bot["api"];
retry?: RetryConfig;
/** New name for the topic (1-128 characters). */
name?: string;
/** Custom emoji ID for the topic icon. */
iconCustomEmojiId?: string;
};
export type EditForumTopicResult = {
ok: boolean;
};
/**
* Edit an existing forum topic in a Telegram supergroup.
* @param chatIdInput - Chat ID of the supergroup
* @param messageThreadId - Thread ID of the topic to edit
* @param opts - Configuration including new name and/or icon
*/
export async function editForumTopicTelegram(
chatIdInput: string | number,
messageThreadId: number,
opts: EditForumTopicOpts = {},
): Promise<EditForumTopicResult> {
if (!opts.name && !opts.iconCustomEmojiId) {
throw new Error("At least one of name or iconCustomEmojiId is required to edit a forum topic");
}
const cfg = loadConfig();
const account = resolveTelegramAccount({
cfg,
accountId: opts.accountId,
});
const token = resolveToken(opts.token, account);
const chatId = normalizeChatId(String(chatIdInput));
const client = resolveTelegramClientOptions(account);
const api = opts.api ?? new Bot(token, client ? { client } : undefined).api;
const request = createTelegramRetryRunner({
retry: opts.retry,
configRetry: account.config.retry,
verbose: opts.verbose,
});
const logHttpError = createTelegramHttpLogger(cfg);
const requestWithDiag = <T>(fn: () => Promise<T>, label?: string) =>
withTelegramApiErrorLogging({
operation: label ?? "request",
fn: () => request(fn, label),
}).catch((err) => {
logHttpError(label ?? "request", err);
throw err;
});
const params: Record<string, unknown> = {};
if (opts.name) {
params.name = opts.name;
}
if (opts.iconCustomEmojiId) {
params.icon_custom_emoji_id = opts.iconCustomEmojiId;
}
await requestWithDiag(
() => api.editForumTopic(chatId, messageThreadId, params),
"editForumTopic",
);
logVerbose(`[telegram] Edited forum topic ${messageThreadId} in chat ${chatId}`);
return { ok: true };
}
/**
* Create a new forum topic in a Telegram supergroup with topics enabled.
* @param chatIdInput - Chat ID of the supergroup