@zhin.js/adapter-telegram 1.1.25 → 1.1.27

package/agents/telegram/skills/telegram-chat-admin/tools/pin_message/index.js

@@ -1,21 +1,20 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
 import { messages as t } from "../../../../messages.js";
+import { currentChat } from "../../../../conversation.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
-import { platformPermission } from '@zhin.js/permission';
 export default defineAgentTool({
-    description: '置顶 Telegram 群组消息',
+    description: '置顶当前 Telegram 群组中的消息',
     inputSchema: z.object({
-        chat_id: z.string().describe('聊天 ID'),
         message_id: z.string().describe('消息 ID'),
     }),
     adapter: 'telegram',
     scopes: ["group", "channel"],
     tags: ['telegram'],
-    permissions: [platformPermission('telegram', 'pin_messages')],
-    async execute({ chat_id, message_id }, context) {
+    permissions: ['platform-permission:pin_messages', 'bot-permission:pin_messages'],
+    async execute({ message_id }, context) {
         const endpoint = context.$client;
-        const success = await endpoint.pinMessage(Number(chat_id), Number(message_id));
+        const success = await endpoint.pinMessage(currentChat(context), Number(message_id));
         return { success, message: success ? t(context.locale, 'pinDone') : t(context.locale, 'operationFailed') };
     },
 });

package/agents/telegram/skills/telegram-chat-admin/tools/pin_message/index.ts

@@ -1,21 +1,20 @@
 import { messages as t } from "../../../../messages.js";
+import { currentChat } from "../../../../conversation.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
-import { platformPermission } from '@zhin.js/permission';
 
-export default defineAgentTool<{ chat_id: string; message_id: string }>({
-  description: '置顶 Telegram 群组消息',
+export default defineAgentTool<{ message_id: string }>({
+  description: '置顶当前 Telegram 群组中的消息',
   inputSchema: z.object({
-    chat_id: z.string().describe('聊天 ID'),
     message_id: z.string().describe('消息 ID'),
   }),
   adapter: 'telegram',
   scopes: ["group","channel"],
   tags: ['telegram'],
-  permissions: [platformPermission('telegram', 'pin_messages')],
-  async execute({ chat_id, message_id  }: { chat_id: string; message_id: string }, context) {
+  permissions: ['platform-permission:pin_messages', 'bot-permission:pin_messages'],
+  async execute({ message_id }, context) {
     const endpoint = context.$client;
-    const success = await endpoint.pinMessage(Number(chat_id), Number(message_id));
+    const success = await endpoint.pinMessage(currentChat(context), Number(message_id));
     return { success, message: success ? t(context.locale, 'pinDone') : t(context.locale, 'operationFailed') };
   },
 });

package/agents/telegram/skills/telegram-chat-admin/tools/set_description/index.js

@@ -1,19 +1,20 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
 import { messages as t } from "../../../../messages.js";
+import { currentChat } from "../../../../conversation.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 export default defineAgentTool({
-    description: '设置 Telegram 群组描述',
+    description: '设置当前 Telegram 群组描述',
     inputSchema: z.object({
-        chat_id: z.string().describe('聊天 ID'),
         description: z.string().describe('群描述文字'),
     }),
     adapter: 'telegram',
     scopes: ["group", "channel"],
+    permissions: ['platform-permission:change_info', 'bot-permission:change_info'],
     tags: ['telegram'],
-    async execute({ chat_id, description }, context) {
+    async execute({ description }, context) {
         const endpoint = context.$client;
-        const success = await endpoint.setChatDescription(Number(chat_id), description);
+        const success = await endpoint.setChatDescription(currentChat(context), description);
         return { success, message: success ? t(context.locale, 'descriptionUpdated') : t(context.locale, 'operationFailed') };
     },
 });

package/agents/telegram/skills/telegram-chat-admin/tools/set_description/index.ts

@@ -1,19 +1,20 @@
 import { messages as t } from "../../../../messages.js";
+import { currentChat } from "../../../../conversation.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
-export default defineAgentTool<{ chat_id: string; description: string }>({
-  description: '设置 Telegram 群组描述',
+export default defineAgentTool<{ description: string }>({
+  description: '设置当前 Telegram 群组描述',
   inputSchema: z.object({
-    chat_id: z.string().describe('聊天 ID'),
     description: z.string().describe('群描述文字'),
   }),
   adapter: 'telegram',
   scopes: ["group","channel"],
+  permissions: ['platform-permission:change_info', 'bot-permission:change_info'],
   tags: ['telegram'],
-  async execute({ chat_id, description  }: { chat_id: string; description: string }, context) {
+  async execute({ description }, context) {
     const endpoint = context.$client;
-    const success = await endpoint.setChatDescription(Number(chat_id), description);
+    const success = await endpoint.setChatDescription(currentChat(context), description);
     return { success, message: success ? t(context.locale, 'descriptionUpdated') : t(context.locale, 'operationFailed') };
   },
 });

package/agents/telegram/skills/telegram-chat-admin/tools/unpin_message/index.js

@@ -1,21 +1,20 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
 import { messages as t } from "../../../../messages.js";
+import { currentChat } from "../../../../conversation.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
-import { platformPermission } from '@zhin.js/permission';
 export default defineAgentTool({
-    description: '取消置顶 Telegram 群组消息',
+    description: '取消置顶当前 Telegram 群组中的消息',
     inputSchema: z.object({
-        chat_id: z.string().describe('聊天 ID'),
         message_id: z.string().optional().describe('消息 ID（可选，不提供则取消所有置顶）'),
     }),
     adapter: 'telegram',
     scopes: ["group", "channel"],
     tags: ['telegram'],
-    permissions: [platformPermission('telegram', 'pin_messages')],
-    async execute({ chat_id, message_id }, context) {
+    permissions: ['platform-permission:pin_messages', 'bot-permission:pin_messages'],
+    async execute({ message_id }, context) {
         const endpoint = context.$client;
-        const success = await endpoint.unpinMessage(Number(chat_id), message_id ? Number(message_id) : undefined);
+        const success = await endpoint.unpinMessage(currentChat(context), message_id ? Number(message_id) : undefined);
         return { success, message: success ? t(context.locale, 'messageUnpinned') : t(context.locale, 'operationFailed') };
     },
 });

package/agents/telegram/skills/telegram-chat-admin/tools/unpin_message/index.ts

@@ -1,21 +1,20 @@
 import { messages as t } from "../../../../messages.js";
+import { currentChat } from "../../../../conversation.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
-import { platformPermission } from '@zhin.js/permission';
 
-export default defineAgentTool<{ chat_id: string; message_id?: string }>({
-  description: '取消置顶 Telegram 群组消息',
+export default defineAgentTool<{ message_id?: string }>({
+  description: '取消置顶当前 Telegram 群组中的消息',
   inputSchema: z.object({
-    chat_id: z.string().describe('聊天 ID'),
     message_id: z.string().optional().describe('消息 ID（可选，不提供则取消所有置顶）'),
   }),
   adapter: 'telegram',
   scopes: ["group","channel"],
   tags: ['telegram'],
-  permissions: [platformPermission('telegram', 'pin_messages')],
-  async execute({ chat_id, message_id  }: { chat_id: string; message_id?: string }, context) {
+  permissions: ['platform-permission:pin_messages', 'bot-permission:pin_messages'],
+  async execute({ message_id }, context) {
     const endpoint = context.$client;
-    const success = await endpoint.unpinMessage(Number(chat_id), message_id ? Number(message_id) : undefined);
+    const success = await endpoint.unpinMessage(currentChat(context), message_id ? Number(message_id) : undefined);
     return { success, message: success ? t(context.locale, 'messageUnpinned') : t(context.locale, 'operationFailed') };
   },
 });

package/agents/telegram/skills/telegram-group-permissions/tools/set_permissions/index.js

@@ -1,12 +1,11 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
 import { messages as t } from "../../../../messages.js";
+import { currentChat } from "../../../../conversation.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
-import { platformPermission } from '@zhin.js/permission';
 export default defineAgentTool({
-    description: '设置 Telegram 群组的默认成员权限',
+    description: '设置当前 Telegram 群组的默认成员权限',
     inputSchema: z.object({
-        chat_id: z.string().describe('聊天 ID'),
         can_send_messages: z.boolean().optional().describe('是否可以发消息'),
         can_send_photos: z.boolean().optional().describe('是否可以发图片'),
         can_send_videos: z.boolean().optional().describe('是否可以发视频'),
@@ -20,15 +19,15 @@ export default defineAgentTool({
     adapter: 'telegram',
     scopes: ["group"],
     tags: ['telegram'],
-    permissions: [platformPermission('telegram', 'manage_chat')],
-    async execute({ chat_id, ...perms }, context) {
+    permissions: ['platform-permission:restrict_members', 'bot-permission:restrict_members'],
+    async execute(perms, context) {
         const endpoint = context.$client;
         const permissions = {};
         for (const [k, v] of Object.entries(perms)) {
             if (typeof v === 'boolean')
                 permissions[k] = v;
         }
-        const success = await endpoint.setChatPermissionsAll(Number(chat_id), permissions);
+        const success = await endpoint.setChatPermissionsAll(currentChat(context), permissions);
         return { success, message: success ? t(context.locale, 'permissionsUpdated') : t(context.locale, 'operationFailed') };
     },
 });

package/agents/telegram/skills/telegram-group-permissions/tools/set_permissions/index.ts

@@ -1,12 +1,11 @@
 import { messages as t } from "../../../../messages.js";
+import { currentChat } from "../../../../conversation.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
-import { platformPermission } from '@zhin.js/permission';
 
-export default defineAgentTool<{ chat_id: string; can_send_messages?: boolean; can_send_photos?: boolean; can_send_videos?: boolean; can_send_polls?: boolean; can_send_other_messages?: boolean; can_add_web_page_previews?: boolean; can_change_info?: boolean; can_invite_users?: boolean; can_pin_messages?: boolean }>({
-  description: '设置 Telegram 群组的默认成员权限',
+export default defineAgentTool<{ can_send_messages?: boolean; can_send_photos?: boolean; can_send_videos?: boolean; can_send_polls?: boolean; can_send_other_messages?: boolean; can_add_web_page_previews?: boolean; can_change_info?: boolean; can_invite_users?: boolean; can_pin_messages?: boolean }>({
+  description: '设置当前 Telegram 群组的默认成员权限',
   inputSchema: z.object({
-    chat_id: z.string().describe('聊天 ID'),
     can_send_messages: z.boolean().optional().describe('是否可以发消息'),
     can_send_photos: z.boolean().optional().describe('是否可以发图片'),
     can_send_videos: z.boolean().optional().describe('是否可以发视频'),
@@ -20,14 +19,14 @@ export default defineAgentTool<{ chat_id: string; can_send_messages?: boolean; c
   adapter: 'telegram',
   scopes: ["group"],
   tags: ['telegram'],
-  permissions: [platformPermission('telegram', 'manage_chat')],
-  async execute({ chat_id, ...perms  }: { chat_id: string; can_send_messages?: boolean; can_send_photos?: boolean; can_send_videos?: boolean; can_send_polls?: boolean; can_send_other_messages?: boolean; can_add_web_page_previews?: boolean; can_change_info?: boolean; can_invite_users?: boolean; can_pin_messages?: boolean }, context) {
+  permissions: ['platform-permission:restrict_members', 'bot-permission:restrict_members'],
+  async execute(perms: { can_send_messages?: boolean; can_send_photos?: boolean; can_send_videos?: boolean; can_send_polls?: boolean; can_send_other_messages?: boolean; can_add_web_page_previews?: boolean; can_change_info?: boolean; can_invite_users?: boolean; can_pin_messages?: boolean }, context) {
     const endpoint = context.$client;
     const permissions: Record<string, boolean> = {};
     for (const [k, v] of Object.entries(perms)) {
       if (typeof v === 'boolean') permissions[k] = v;
     }
-    const success = await endpoint.setChatPermissionsAll(Number(chat_id), permissions);
+    const success = await endpoint.setChatPermissionsAll(currentChat(context), permissions);
     return { success, message: success ? t(context.locale, 'permissionsUpdated') : t(context.locale, 'operationFailed') };
   },
 });

package/agents/telegram/skills/telegram-messages/tools/react/index.js

@@ -1,19 +1,18 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
 import { messages as t } from "../../../../messages.js";
+import { currentChat } from "../../../../conversation.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 export default defineAgentTool({
-    description: '对 Telegram 消息添加表情反应',
+    description: '对当前 Telegram 会话中的消息添加表情反应',
     inputSchema: z.object({
-        chat_id: z.string().describe('聊天 ID'),
-        message_id: z.string().describe('消息 ID'),
+        message_id: z.string().describe('当前会话中的消息 ID'),
         reaction: z.string().describe('反应表情（如 👍、❤️、🔥）'),
     }),
     adapter: 'telegram',
     tags: ['telegram'],
-    async execute({ chat_id, message_id, reaction }, context) {
-        const endpoint = context.$client;
-        const success = await endpoint.setMessageReaction(Number(chat_id), Number(message_id), reaction);
+    async execute({ message_id, reaction }, context) {
+        const success = await context.$client.setMessageReaction(currentChat(context, { allowPrivate: true }), Number(message_id), reaction);
         return { success, message: success ? t(context.locale, 'reactionAdded', { p0: reaction }) : t(context.locale, 'operationFailed') };
     },
 });

package/agents/telegram/skills/telegram-messages/tools/react/index.ts

@@ -1,19 +1,18 @@
 import { messages as t } from "../../../../messages.js";
+import { currentChat } from "../../../../conversation.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
-export default defineAgentTool<{ chat_id: string; message_id: string; reaction: string }>({
-  description: '对 Telegram 消息添加表情反应',
+export default defineAgentTool<{ message_id: string; reaction: string }>({
+  description: '对当前 Telegram 会话中的消息添加表情反应',
   inputSchema: z.object({
-    chat_id: z.string().describe('聊天 ID'),
-    message_id: z.string().describe('消息 ID'),
+    message_id: z.string().describe('当前会话中的消息 ID'),
     reaction: z.string().describe('反应表情（如 👍、❤️、🔥）'),
   }),
   adapter: 'telegram',
   tags: ['telegram'],
-  async execute({ chat_id, message_id, reaction  }: { chat_id: string; message_id: string; reaction: string }, context) {
-    const endpoint = context.$client;
-    const success = await endpoint.setMessageReaction(Number(chat_id), Number(message_id), reaction);
+  async execute({ message_id, reaction }, context) {
+    const success = await context.$client.setMessageReaction(currentChat(context, { allowPrivate: true }), Number(message_id), reaction);
     return { success, message: success ? t(context.locale, 'reactionAdded', { p0: reaction }) : t(context.locale, 'operationFailed') };
   },
 });

package/agents/telegram/skills/telegram-messages/tools/send_poll/index.js

@@ -1,11 +1,11 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
 import { messages as t } from "../../../../messages.js";
+import { sendToCurrentChat } from "../../../../conversation.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 export default defineAgentTool({
-    description: '在 Telegram 群组中发起投票',
+    description: '在当前 Telegram 会话中发起投票',
     inputSchema: z.object({
-        chat_id: z.string().describe('聊天 ID'),
         question: z.string().describe('投票问题'),
         options: z.string().describe('选项 JSON 数组，如 ["A","B","C"]'),
         is_anonymous: z.boolean().optional().describe('是否匿名投票，默认 true'),
@@ -13,8 +13,7 @@ export default defineAgentTool({
     }),
     adapter: 'telegram',
     tags: ['telegram'],
-    async execute({ chat_id, question, options, is_anonymous, allows_multiple }, context) {
-        const endpoint = context.$client;
+    async execute({ question, options, is_anonymous, allows_multiple }, context) {
         let optList;
         try {
             optList = JSON.parse(options);
@@ -25,8 +24,10 @@ export default defineAgentTool({
         if (!Array.isArray(optList) || optList.length < 2) {
             return { success: false, message: t(context.locale, 'pollOptionCount') };
         }
-        const result = await endpoint.sendPoll({ chatId: Number(chat_id), question, options: optList,
-            isAnonymous: is_anonymous ?? true, allowsMultipleAnswers: allows_multiple ?? false });
-        return { success: true, message_id: result.message_id, message: t(context.locale, 'pollSent') };
+        // `telegram:poll` is the Telegram adapter's namespaced outbound segment.
+        const result = await sendToCurrentChat(context, { type: 'telegram:poll', data: {
+                question, options: optList, is_anonymous: is_anonymous ?? true, allows_multiple_answers: allows_multiple ?? false,
+            } });
+        return { ...result, message: t(context.locale, result.success ? 'pollSent' : 'operationFailed') };
     },
 });

package/agents/telegram/skills/telegram-messages/tools/send_poll/index.ts

@@ -1,11 +1,11 @@
 import { messages as t } from "../../../../messages.js";
+import { sendToCurrentChat } from "../../../../conversation.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
-export default defineAgentTool<{ chat_id: string; question: string; options: string; is_anonymous?: boolean; allows_multiple?: boolean }>({
-  description: '在 Telegram 群组中发起投票',
+export default defineAgentTool<{ question: string; options: string; is_anonymous?: boolean; allows_multiple?: boolean }>({
+  description: '在当前 Telegram 会话中发起投票',
   inputSchema: z.object({
-    chat_id: z.string().describe('聊天 ID'),
     question: z.string().describe('投票问题'),
     options: z.string().describe('选项 JSON 数组，如 ["A","B","C"]'),
     is_anonymous: z.boolean().optional().describe('是否匿名投票，默认 true'),
@@ -13,8 +13,7 @@ export default defineAgentTool<{ chat_id: string; question: string; options: str
   }),
   adapter: 'telegram',
   tags: ['telegram'],
-  async execute({ chat_id, question, options, is_anonymous, allows_multiple  }: { chat_id: string; question: string; options: string; is_anonymous?: boolean; allows_multiple?: boolean }, context) {
-    const endpoint = context.$client;
+  async execute({ question, options, is_anonymous, allows_multiple }, context) {
     let optList: string[];
     try {
       optList = JSON.parse(options);
@@ -24,8 +23,10 @@ export default defineAgentTool<{ chat_id: string; question: string; options: str
     if (!Array.isArray(optList) || optList.length < 2) {
       return { success: false, message: t(context.locale, 'pollOptionCount') };
     }
-    const result = await endpoint.sendPoll({ chatId: Number(chat_id), question, options: optList,
-      isAnonymous: is_anonymous ?? true, allowsMultipleAnswers: allows_multiple ?? false });
-    return { success: true, message_id: result.message_id, message: t(context.locale, 'pollSent') };
+    // `telegram:poll` is the Telegram adapter's namespaced outbound segment.
+    const result = await sendToCurrentChat(context, { type: 'telegram:poll', data: {
+      question, options: optList, is_anonymous: is_anonymous ?? true, allows_multiple_answers: allows_multiple ?? false,
+    } });
+    return { ...result, message: t(context.locale, result.success ? 'pollSent' : 'operationFailed') };
   },
 });

package/agents/telegram/skills/telegram-messages/tools/send_sticker/index.js

@@ -1,18 +1,18 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
 import { messages as t } from "../../../../messages.js";
+import { sendToCurrentChat } from "../../../../conversation.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 export default defineAgentTool({
-    description: '发送 Telegram 贴纸',
+    description: '在当前 Telegram 会话发送贴纸',
     inputSchema: z.object({
-        chat_id: z.string().describe('聊天 ID'),
-        sticker: z.string().describe('贴纸 file_id 或 URL'),
+        sticker: z.string().describe('贴纸 file_id 或 http(s) URL'),
     }),
     adapter: 'telegram',
     tags: ['telegram'],
-    async execute({ chat_id, sticker }, context) {
-        const endpoint = context.$client;
-        const result = await endpoint.sendStickerMessage(Number(chat_id), sticker);
-        return { success: true, message_id: result.message_id, message: t(context.locale, 'stickerSent') };
+    async execute({ sticker }, context) {
+        // `telegram:sticker` is the Telegram adapter's namespaced outbound segment.
+        const result = await sendToCurrentChat(context, { type: 'telegram:sticker', data: { sticker } });
+        return { ...result, message: t(context.locale, result.success ? 'stickerSent' : 'operationFailed') };
     },
 });

package/agents/telegram/skills/telegram-messages/tools/send_sticker/index.ts

@@ -1,18 +1,18 @@
 import { messages as t } from "../../../../messages.js";
+import { sendToCurrentChat } from "../../../../conversation.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
-export default defineAgentTool<{ chat_id: string; sticker: string }>({
-  description: '发送 Telegram 贴纸',
+export default defineAgentTool<{ sticker: string }>({
+  description: '在当前 Telegram 会话发送贴纸',
   inputSchema: z.object({
-    chat_id: z.string().describe('聊天 ID'),
-    sticker: z.string().describe('贴纸 file_id 或 URL'),
+    sticker: z.string().describe('贴纸 file_id 或 http(s) URL'),
   }),
   adapter: 'telegram',
   tags: ['telegram'],
-  async execute({ chat_id, sticker  }: { chat_id: string; sticker: string }, context) {
-    const endpoint = context.$client;
-    const result = await endpoint.sendStickerMessage(Number(chat_id), sticker);
-    return { success: true, message_id: result.message_id, message: t(context.locale, 'stickerSent') };
+  async execute({ sticker }, context) {
+    // `telegram:sticker` is the Telegram adapter's namespaced outbound segment.
+    const result = await sendToCurrentChat(context, { type: 'telegram:sticker', data: { sticker } });
+    return { ...result, message: t(context.locale, result.success ? 'stickerSent' : 'operationFailed') };
   },
 });

package/lib/console-spec.js

@@ -2,14 +2,91 @@ export const telegramConsoleSpec = {
     adapterKey: 'telegram',
     adapterDisplayName: 'Telegram',
     fields: [
-        { key: 'token', required: true, env: true, description: 'Telegram bot token' },
-        { key: 'apiBaseUrl', description: 'Telegram Bot API URL' },
-        { key: 'polling', type: 'boolean', description: 'Use long polling; false selects webhook mode' },
-        { key: 'streaming', type: 'boolean', description: 'Show private-chat drafts while generating (default true)' },
-        { key: 'streamingIntervalMs', type: 'number', description: 'Delay between draft updates in milliseconds (default 500)' },
-        { key: 'webhook.domain', description: 'Public webhook origin' },
-        { key: 'webhook.path', description: 'Local webhook route' },
-        { key: 'webhook.secretToken', env: true, description: 'Webhook secret token' },
+        {
+            key: 'token',
+            required: true,
+            env: true,
+            label: 'Bot Token (机器人令牌)',
+            labelI18n: { en: 'Bot Token' },
+            group: '基础认证',
+            groupI18n: { en: 'Basic Auth' },
+            placeholder: '123456789:AAH...',
+            description: '从 @BotFather 获取的 Telegram Bot Token',
+            descriptionI18n: { en: 'Telegram bot token from @BotFather' },
+        },
+        {
+            key: 'polling',
+            type: 'boolean',
+            label: '长轮询模式 (Polling)',
+            labelI18n: { en: 'Long Polling Mode' },
+            group: '连接与回调',
+            groupI18n: { en: 'Connection & Webhook' },
+            description: '开启后使用长轮询拉取消息；关闭则使用 Webhook 模式',
+            descriptionI18n: { en: 'Use long polling; false selects webhook mode' },
+        },
+        {
+            key: 'webhook.domain',
+            label: 'Webhook 公网域名',
+            labelI18n: { en: 'Webhook Public Domain' },
+            group: '连接与回调',
+            groupI18n: { en: 'Connection & Webhook' },
+            placeholder: 'https://bot.example.com',
+            description: 'Webhook 模式的公网访问域名（Origin）',
+            descriptionI18n: { en: 'Public webhook origin' },
+        },
+        {
+            key: 'webhook.path',
+            label: 'Webhook 本地路由',
+            labelI18n: { en: 'Webhook Local Path' },
+            group: '连接与回调',
+            groupI18n: { en: 'Connection & Webhook' },
+            placeholder: '/telegram/webhook',
+            description: '本地 HTTP 服务监听的 Webhook 路径',
+            descriptionI18n: { en: 'Local webhook route' },
+        },
+        {
+            key: 'webhook.secretToken',
+            env: true,
+            label: 'Webhook 签名密钥',
+            labelI18n: { en: 'Webhook Secret Token' },
+            group: '连接与回调',
+            groupI18n: { en: 'Connection & Webhook' },
+            placeholder: '自定义随机字符串（校验 X-Telegram-Bot-Api-Secret-Token）',
+            placeholderI18n: { en: 'Optional secret token for webhook header verification' },
+            description: 'Webhook 请求头校验密钥（可选）',
+            descriptionI18n: { en: 'Webhook secret token' },
+        },
+        {
+            key: 'streaming',
+            type: 'boolean',
+            label: '流式草稿回复',
+            labelI18n: { en: 'Streaming Draft Reply' },
+            group: '流式体验与代理',
+            groupI18n: { en: 'Streaming & Proxy' },
+            description: '私聊生成回复时实时更新草稿内容（默认开启）',
+            descriptionI18n: { en: 'Show private-chat drafts while generating (default true)' },
+        },
+        {
+            key: 'streamingIntervalMs',
+            type: 'number',
+            label: '流式刷新间隔 (ms)',
+            labelI18n: { en: 'Streaming Interval (ms)' },
+            group: '流式体验与代理',
+            groupI18n: { en: 'Streaming & Proxy' },
+            placeholder: '500',
+            description: '流式消息每次编辑的最小间隔毫秒数（默认 500）',
+            descriptionI18n: { en: 'Delay between draft updates in milliseconds (default 500)' },
+        },
+        {
+            key: 'apiBaseUrl',
+            label: '自定义 Bot API 地址',
+            labelI18n: { en: 'Custom Bot API URL' },
+            group: '流式体验与代理',
+            groupI18n: { en: 'Streaming & Proxy' },
+            placeholder: 'https://api.telegram.org',
+            description: '自建 Telegram Bot API 反代或本地服务地址（可选）',
+            descriptionI18n: { en: 'Telegram Bot API URL' },
+        },
     ],
     docsUrl: 'https://zhin.js.org/adapters/telegram',
     readPermission: 'telegram:read',

package/lib/endpoint.d.ts

@@ -17,7 +17,8 @@ export { TelegramClient, type TelegramClientApi, type TelegramFetch } from './te
 /**
  * Telegram Bot API 无列表类接口（无 getMyChats/getChatMembers），
  * 仅 getChat/getChatMember 按已知 id 单查，不构成列表能力；
- * 因此本 endpoint 不暴露 EndpointManagement（Console 社交面 RPC 对该平台保持未接线）。
+ * 因此本 endpoint 的 EndpointManagement 只有 `inspectSelfStanding`（ADR 0056 §1：getChatMember bot），
+ * Console 社交面 RPC 对该平台保持未接线。
  */
 export declare class TelegramEndpoint extends TelegramClient implements Endpoint {
     #private;