@zhin.js/adapter-telegram 5.0.0 → 5.0.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-telegram",
-  "version": "5.0.0",
+  "version": "5.0.2",
   "description": "Zhin.js adapter for Telegram",
   "type": "module",
   "main": "./lib/index.js",
@@ -35,28 +35,35 @@
     "telegraf": "^4.16.3"
   },
   "devDependencies": {
-    "@types/node": "^25.9.2",
+    "@types/node": "^26.1.0",
     "@types/react": "^19.2.17",
     "@types/react-dom": "^19.2.3",
-    "lucide-react": "^1.21.0",
+    "lucide-react": "^1.22.0",
     "typescript": "^6.0.3",
-    "@zhin.js/client": "2.0.3",
-    "@zhin.js/cli": "1.0.91",
-    "@zhin.js/host-api": "2.0.3",
-    "@zhin.js/contract": "1.0.1",
-    "@zhin.js/host-router": "2.0.1",
-    "zhin.js": "4.1.0",
-    "@zhin.js/logger": "1.0.72"
+    "zod": "^4.4.3",
+    "@zhin.js/contract": "1.0.3",
+    "@zhin.js/host-router": "2.0.3",
+    "@zhin.js/client": "2.0.5",
+    "@zhin.js/host-api": "2.0.5",
+    "@zhin.js/cli": "1.0.93",
+    "@zhin.js/logger": "1.0.74",
+    "zhin.js": "4.1.2",
+    "@zhin.js/agent": "1.0.3"
   },
   "peerDependencies": {
-    "@zhin.js/client": "2.0.3",
-    "@zhin.js/contract": "1.0.1",
-    "zhin.js": "4.1.0",
-    "@zhin.js/host-router": "2.0.1",
-    "@zhin.js/host-api": "2.0.3",
-    "@zhin.js/logger": "1.0.72"
+    "zod": "^4.0.0",
+    "@zhin.js/host-api": "2.0.5",
+    "@zhin.js/contract": "1.0.3",
+    "@zhin.js/client": "2.0.5",
+    "@zhin.js/host-router": "2.0.3",
+    "@zhin.js/agent": "1.0.3",
+    "@zhin.js/logger": "1.0.74",
+    "zhin.js": "4.1.2"
   },
   "peerDependenciesMeta": {
+    "@zhin.js/agent": {
+      "optional": true
+    },
     "@zhin.js/client": {
       "optional": true
     },
@@ -65,6 +72,9 @@
     },
     "@zhin.js/host-api": {
       "optional": true
+    },
+    "zod": {
+      "optional": true
     }
   },
   "files": [
@@ -72,7 +82,7 @@
     "lib",
     "client",
     "dist",
-    "skills",
+    "agent",
     "plugin.yml",
     "README.md",
     "CHANGELOG.md"

package/src/adapter.ts

@@ -9,6 +9,7 @@ import type { TelegramEndpointConfig } from "./types.js";
 export class TelegramAdapter extends Adapter<TelegramEndpoint> {
   static override readonly capabilities = ['inbound', 'outbound'] as const;
   static override outboundRichSegmentPolicy = OUTBOUND_RICH_SEGMENT_POLICY_IM_FULL;
+  static override interactivePolicy = 'native' as const;
 
   constructor(plugin: Plugin) {
     super(plugin, "telegram", []);
@@ -18,9 +19,9 @@ export class TelegramAdapter extends Adapter<TelegramEndpoint> {
     return new TelegramEndpoint(this, config);
   }
 
-  // ── IGroupManagement 标准群管方法 ──────────────────────────────────
+  // ── ISceneManagement 标准群管方法 ──────────────────────────────────
 
-  async kickMember(endpointId: string, sceneId: string, userId: string) {
+  async removeMember(endpointId: string, sceneId: string, userId: string) {
     const endpoint = this.endpoints.get(endpointId);
     if (!endpoint) throw new Error(`Endpoint ${endpointId} 不存在`);
     return endpoint.kickMember(Number(sceneId), Number(userId));
@@ -38,19 +39,19 @@ export class TelegramAdapter extends Adapter<TelegramEndpoint> {
     return endpoint.muteMember(Number(sceneId), Number(userId), duration);
   }
 
-  async setAdmin(endpointId: string, sceneId: string, userId: string, enable = true) {
+  async setModerator(endpointId: string, sceneId: string, userId: string, enable = true) {
     const endpoint = this.endpoints.get(endpointId);
     if (!endpoint) throw new Error(`Endpoint ${endpointId} 不存在`);
     return endpoint.setAdmin(Number(sceneId), Number(userId), enable);
   }
 
-  async setGroupName(endpointId: string, sceneId: string, name: string) {
+  async renameScene(endpointId: string, sceneId: string, name: string) {
     const endpoint = this.endpoints.get(endpointId);
     if (!endpoint) throw new Error(`Endpoint ${endpointId} 不存在`);
     return endpoint.setChatTitle(Number(sceneId), name);
   }
 
-  async getGroupInfo(endpointId: string, sceneId: string) {
+  async getSceneInfo(endpointId: string, sceneId: string) {
     const endpoint = this.endpoints.get(endpointId);
     if (!endpoint) throw new Error(`Endpoint ${endpointId} 不存在`);
     return endpoint.getChatInfo(Number(sceneId));

package/src/endpoint.ts

@@ -10,10 +10,12 @@ import {
   SendContent,
   MessageSegment,
   segment,
+  expandInteractiveSegmentsInContent,
   type QuotedMessagePayload,} from 'zhin.js';
 import type { TelegramEndpointConfig, TelegramSenderInfo } from "./types.js";
 import type { TelegramAdapter } from "./adapter.js";
 import { normalizeTelegramChatMember } from "./platform-permit.js";
+import { fromCanonicalSegments, toCanonicalSegments } from './segment-mapper.js';
 
 export class TelegramEndpoint extends Telegraf implements Endpoint<TelegramEndpointConfig, TelegramMessage> {
   $connected: boolean = false;
@@ -43,8 +45,12 @@ export class TelegramEndpoint extends Telegraf implements Endpoint<TelegramEndpo
 
       // Set up callback query handler (for inline buttons)
       this.on("callback_query", async (ctx) => {
-        // Handle callback queries as special messages
         if (ctx.callbackQuery && "data" in ctx.callbackQuery) {
+          try {
+            await ctx.answerCbQuery();
+          } catch {
+            // already answered
+          }
           const message = this.$formatCallbackQuery(ctx);
           this.adapter.emit("message.receive", message);
           this.pluginLogger.debug(
@@ -169,9 +175,10 @@ export class TelegramEndpoint extends Telegraf implements Endpoint<TelegramEndpo
     const channelId = msg.chat.id.toString();
 
     // Parse message content
-    const content = this.parseMessageContent(msg);
-    const quoteId = Message.quoteIdFromContent(content);
-    Message.alignReplySegments(content, quoteId);
+    const wire = this.parseMessageContent(msg);
+    const quoteId = Message.quoteIdFromContent(wire);
+    Message.alignReplySegments(wire, quoteId);
+    const content = toCanonicalSegments(wire);
 
     const result = Message.from(msg, {
       $id: msg.message_id.toString(),
@@ -271,7 +278,14 @@ export class TelegramEndpoint extends Telegraf implements Endpoint<TelegramEndpo
         id: channelId,
         type: channelType,
       },
-      $content: [{ type: "text", data: { text: query.data } }],
+      $content: [{
+        type: "action",
+        data: {
+          id: query.id,
+          payload: query.data,
+          sourceMessageId: msg && "message_id" in msg ? String(msg.message_id) : undefined,
+        },
+      }],
       $raw: query.data,
       $timestamp: Date.now(),
       $recall: async () => {
@@ -508,7 +522,9 @@ export class TelegramEndpoint extends Telegraf implements Endpoint<TelegramEndpo
   async $sendMessage(options: SendOptions): Promise<string> {
     try {
       const chatId = parseInt(options.id);
-      const result = await this.sendContentToChat(chatId, options.content);
+      const canonical = expandInteractiveSegmentsInContent(options.content);
+      const wire = fromCanonicalSegments(canonical);
+      const result = await this.sendContentToChat(chatId, wire);
       this.messageChatMap.set(result.message_id.toString(), options.id);
       this.pluginLogger.debug(
         `${this.$config.name} send ${options.type}(${options.id}): ${segment.raw(options.content)}`
@@ -520,6 +536,38 @@ export class TelegramEndpoint extends Telegraf implements Endpoint<TelegramEndpo
     }
   }
 
+  async $editMessage(options: import('zhin.js').EditMessageOptions): Promise<void> {
+    const chatId = parseInt(options.id);
+    const messageId = parseInt(options.messageId);
+    const content = Array.isArray(options.content) ? options.content : [options.content];
+    let textContent = "";
+    let keyboard: { inline_keyboard: Array<Array<{ text: string; callback_data: string }>> } | undefined;
+    for (const seg of content) {
+      if (typeof seg === "string") {
+        textContent += seg;
+        continue;
+      }
+      if (seg.type === "text") textContent += seg.data.text || "";
+      if (seg.type === "keyboard") {
+        keyboard = {
+          inline_keyboard: (seg.data.rows ?? []).map((row: Array<{ label: string; payload: string; disabled?: boolean }>) =>
+            row.map((btn) => ({
+              text: btn.label,
+              callback_data: String(btn.payload).slice(0, 64),
+            })),
+          ),
+        };
+      }
+    }
+    await this.telegram.editMessageText(
+      chatId,
+      messageId,
+      undefined,
+      textContent.trim() || " ",
+      keyboard ? { reply_markup: keyboard } : {},
+    );
+  }
+
   private async sendContentToChat(
     chatId: number,
     content: SendContent,
@@ -691,6 +739,20 @@ export class TelegramEndpoint extends Telegraf implements Endpoint<TelegramEndpo
               reply_parameters: { message_id: parseInt(data.id) },
               ...extraOptions,
             });
+
+        case "keyboard": {
+          const rows = (data.rows ?? []).map((row: Array<{ label: string; payload: string; disabled?: boolean }>) =>
+            row.map((btn) => ({
+              text: btn.label,
+              callback_data: String(btn.payload).slice(0, 64),
+            })),
+          );
+          return await this.telegram.sendMessage(chatId, textContent.trim() || " ", {
+            reply_markup: { inline_keyboard: rows },
+            ...extraOptions,
+          });
+        }
+
         default:
           // Unknown segment type, add as text
           textContent += data.text || `[${type}]`;
@@ -707,7 +769,6 @@ export class TelegramEndpoint extends Telegraf implements Endpoint<TelegramEndpo
   }
 
   async $recallMessage(id: string): Promise<void> {
-    // Telegram requires both chat_id and message_id to delete a message
     // The Endpoint interface only provides message_id, making recall impossible
     // Users should use message.$recall() instead, which has the full context
     throw new Error(

package/src/index.ts

@@ -2,14 +2,14 @@
  * Telegram 适配器入口：类型扩展、导出、注册
  */
 import path from "node:path";
-import { usePlugin, type Plugin, type Context, type IGroupManagement, createGroupManagementTools, type ToolFeature } from "zhin.js";
+import { usePlugin, type Plugin, type Context, type ISceneManagement, createSceneManagementTools, type ToolFeature } from "zhin.js";
 import { TelegramAdapter } from "./adapter.js";
 import { PageManager } from "@zhin.js/host-api";
 import {
-  platformPermit,
   registerTelegramPlatformPermitChecker,
   telegramGroupPermitResolver,
 } from "./platform-permit.js";
+import { setTelegramAgentDeps } from "./telegram-agent-deps.js";
 
 declare module "zhin.js" {
   namespace Plugin {
@@ -48,270 +48,20 @@ provide({
 useContext('tool', 'telegram', (toolService: ToolFeature, telegram: TelegramAdapter) => {
   const disposers: (() => void)[] = [];
   disposers.push(registerTelegramPlatformPermitChecker());
-  const groupTools = createGroupManagementTools(
-    telegram as unknown as IGroupManagement,
-    'telegram',
-    { permitResolver: telegramGroupPermitResolver, registerChecker: false },
-  );
-  disposers.push(...groupTools.map(t => toolService.addTool(t, plugin.name)));
-
-  disposers.push(toolService.addTool({
-    name: 'telegram_pin_message',
-    description: '置顶 Telegram 群组消息',
-    parameters: {
-      type: 'object',
-      properties: {
-        endpoint_id: { type: 'string', description: 'Endpoint 名称', contextKey: 'endpointId' },
-        chat_id: { type: 'string', description: '聊天 ID' },
-        message_id: { type: 'string', description: '消息 ID' },
-      },
-      required: ['endpoint_id', 'chat_id', 'message_id'],
-    },
-    platforms: ['telegram'],
-    tags: ['telegram'],
-    permissions: [platformPermit('pin_messages')],
-    execute: async (args: Record<string, any>) => {
-      const endpoint = telegram.endpoints.get(args.endpoint_id);
-      if (!endpoint) throw new Error(`Endpoint ${args.endpoint_id} 不存在`);
-      const success = await endpoint.pinMessage(Number(args.chat_id), Number(args.message_id));
-      return { success, message: success ? '消息已置顶' : '操作失败' };
-    },
-  }, plugin.name));
-
-  disposers.push(toolService.addTool({
-    name: 'telegram_unpin_message',
-    description: '取消置顶 Telegram 群组消息',
-    parameters: {
-      type: 'object',
-      properties: {
-        endpoint_id: { type: 'string', description: 'Endpoint 名称', contextKey: 'endpointId' },
-        chat_id: { type: 'string', description: '聊天 ID' },
-        message_id: { type: 'string', description: '消息 ID（可选，不提供则取消所有置顶）' },
-      },
-      required: ['endpoint_id', 'chat_id'],
-    },
-    platforms: ['telegram'],
-    tags: ['telegram'],
-    permissions: [platformPermit('pin_messages')],
-    execute: async (args: Record<string, any>) => {
-      const endpoint = telegram.endpoints.get(args.endpoint_id);
-      if (!endpoint) throw new Error(`Endpoint ${args.endpoint_id} 不存在`);
-      const success = await endpoint.unpinMessage(Number(args.chat_id), args.message_id ? Number(args.message_id) : undefined);
-      return { success, message: success ? '已取消置顶' : '操作失败' };
-    },
-  }, plugin.name));
-
-  disposers.push(toolService.addTool({
-    name: 'telegram_list_admins',
-    description: '获取 Telegram 群组管理员列表',
-    parameters: {
-      type: 'object',
-      properties: {
-        endpoint_id: { type: 'string', description: 'Endpoint 名称', contextKey: 'endpointId' },
-        chat_id: { type: 'string', description: '聊天 ID' },
-      },
-      required: ['endpoint_id', 'chat_id'],
-    },
-    platforms: ['telegram'],
-    tags: ['telegram'],
-    execute: async (args: Record<string, any>) => {
-      const endpoint = telegram.endpoints.get(args.endpoint_id);
-      if (!endpoint) throw new Error(`Endpoint ${args.endpoint_id} 不存在`);
-      const admins = await endpoint.getChatAdmins(Number(args.chat_id));
-      return {
-        admins: admins.map((a: any) => ({
-          user_id: a.user.id,
-          username: a.user.username,
-          first_name: a.user.first_name,
-          status: a.status,
-        })),
-        count: admins.length,
-      };
-    },
-  }, plugin.name));
-
-  disposers.push(toolService.addTool({
-    name: 'telegram_member_count',
-    description: '获取 Telegram 群组成员数量',
-    parameters: {
-      type: 'object',
-      properties: {
-        endpoint_id: { type: 'string', description: 'Endpoint 名称', contextKey: 'endpointId' },
-        chat_id: { type: 'string', description: '聊天 ID' },
-      },
-      required: ['endpoint_id', 'chat_id'],
-    },
-    platforms: ['telegram'],
-    tags: ['telegram'],
-    execute: async (args: Record<string, any>) => {
-      const endpoint = telegram.endpoints.get(args.endpoint_id);
-      if (!endpoint) throw new Error(`Endpoint ${args.endpoint_id} 不存在`);
-      const count = await endpoint.getChatMemberCount(Number(args.chat_id));
-      return { count, message: `群组共有 ${count} 名成员` };
-    },
-  }, plugin.name));
-
-  disposers.push(toolService.addTool({
-    name: 'telegram_create_invite',
-    description: '创建 Telegram 群组邀请链接',
-    parameters: {
-      type: 'object',
-      properties: {
-        endpoint_id: { type: 'string', description: 'Endpoint 名称', contextKey: 'endpointId' },
-        chat_id: { type: 'string', description: '聊天 ID' },
-      },
-      required: ['endpoint_id', 'chat_id'],
-    },
-    platforms: ['telegram'],
-    tags: ['telegram'],
-    permissions: [platformPermit('chat_administrator')],
-    execute: async (args: Record<string, any>) => {
-      const endpoint = telegram.endpoints.get(args.endpoint_id);
-      if (!endpoint) throw new Error(`Endpoint ${args.endpoint_id} 不存在`);
-      const link = await endpoint.createInviteLink(Number(args.chat_id));
-      return { invite_link: link, message: `邀请链接: ${link}` };
-    },
-  }, plugin.name));
-
-  disposers.push(toolService.addTool({
-    name: 'telegram_send_poll',
-    description: '在 Telegram 群组中发起投票',
-    parameters: {
-      type: 'object',
-      properties: {
-        endpoint_id: { type: 'string', description: 'Endpoint 名称', contextKey: 'endpointId' },
-        chat_id: { type: 'string', description: '聊天 ID' },
-        question: { type: 'string', description: '投票问题' },
-        options: { type: 'string', description: '选项 JSON 数组，如 ["A","B","C"]' },
-        is_anonymous: { type: 'boolean', description: '是否匿名投票，默认 true' },
-        allows_multiple: { type: 'boolean', description: '是否允许多选，默认 false' },
-      },
-      required: ['endpoint_id', 'chat_id', 'question', 'options'],
-    },
-    platforms: ['telegram'],
-    tags: ['telegram'],
-    execute: async (args: Record<string, any>) => {
-      const endpoint = telegram.endpoints.get(args.endpoint_id);
-      if (!endpoint) throw new Error(`Endpoint ${args.endpoint_id} 不存在`);
-      let optList: string[];
-      try {
-        optList = JSON.parse(args.options);
-      } catch {
-        return { success: false, message: 'options 格式错误，应为 JSON 数组' };
-      }
-      if (!Array.isArray(optList) || optList.length < 2) {
-        return { success: false, message: '至少需要 2 个选项' };
-      }
-      const result = await endpoint.sendPoll(
-        Number(args.chat_id), args.question, optList,
-        args.is_anonymous ?? true, args.allows_multiple ?? false,
-      );
-      return { success: true, message_id: result.message_id, message: '投票已发送' };
-    },
-  }, plugin.name));
-
-  disposers.push(toolService.addTool({
-    name: 'telegram_react',
-    description: '对 Telegram 消息添加表情反应',
-    parameters: {
-      type: 'object',
-      properties: {
-        endpoint_id: { type: 'string', description: 'Endpoint 名称', contextKey: 'endpointId' },
-        chat_id: { type: 'string', description: '聊天 ID' },
-        message_id: { type: 'string', description: '消息 ID' },
-        reaction: { type: 'string', description: '反应表情（如 👍、❤️、🔥）' },
-      },
-      required: ['endpoint_id', 'chat_id', 'message_id', 'reaction'],
-    },
-    platforms: ['telegram'],
-    tags: ['telegram'],
-    execute: async (args: Record<string, any>) => {
-      const endpoint = telegram.endpoints.get(args.endpoint_id);
-      if (!endpoint) throw new Error(`Endpoint ${args.endpoint_id} 不存在`);
-      const success = await endpoint.setMessageReaction(Number(args.chat_id), Number(args.message_id), args.reaction);
-      return { success, message: success ? `已添加反应 ${args.reaction}` : '操作失败' };
-    },
-  }, plugin.name));
-
-  disposers.push(toolService.addTool({
-    name: 'telegram_send_sticker',
-    description: '发送 Telegram 贴纸',
-    parameters: {
-      type: 'object',
-      properties: {
-        endpoint_id: { type: 'string', description: 'Endpoint 名称', contextKey: 'endpointId' },
-        chat_id: { type: 'string', description: '聊天 ID' },
-        sticker: { type: 'string', description: '贴纸 file_id 或 URL' },
-      },
-      required: ['endpoint_id', 'chat_id', 'sticker'],
-    },
-    platforms: ['telegram'],
-    tags: ['telegram'],
-    execute: async (args: Record<string, any>) => {
-      const endpoint = telegram.endpoints.get(args.endpoint_id);
-      if (!endpoint) throw new Error(`Endpoint ${args.endpoint_id} 不存在`);
-      const result = await endpoint.sendStickerMessage(Number(args.chat_id), args.sticker);
-      return { success: true, message_id: result.message_id, message: '贴纸已发送' };
-    },
-  }, plugin.name));
-
-  disposers.push(toolService.addTool({
-    name: 'telegram_set_permissions',
-    description: '设置 Telegram 群组的默认成员权限',
-    parameters: {
-      type: 'object',
-      properties: {
-        endpoint_id: { type: 'string', description: 'Endpoint 名称', contextKey: 'endpointId' },
-        chat_id: { type: 'string', description: '聊天 ID' },
-        can_send_messages: { type: 'boolean', description: '是否可以发消息' },
-        can_send_photos: { type: 'boolean', description: '是否可以发图片' },
-        can_send_videos: { type: 'boolean', description: '是否可以发视频' },
-        can_send_polls: { type: 'boolean', description: '是否可以发投票' },
-        can_send_other_messages: { type: 'boolean', description: '是否可以发贴纸/GIF等' },
-        can_add_web_page_previews: { type: 'boolean', description: '是否可以添加网页预览' },
-        can_change_info: { type: 'boolean', description: '是否可以改群信息' },
-        can_invite_users: { type: 'boolean', description: '是否可以邀请用户' },
-        can_pin_messages: { type: 'boolean', description: '是否可以置顶消息' },
-      },
-      required: ['endpoint_id', 'chat_id'],
-    },
-    platforms: ['telegram'],
-    tags: ['telegram'],
-    permissions: [platformPermit('manage_chat')],
-    execute: async (args: Record<string, any>) => {
-      const { endpoint: endpointId, chat_id, ...perms } = args;
+  setTelegramAgentDeps({
+    getEndpoint: (endpointId) => {
       const endpoint = telegram.endpoints.get(endpointId);
       if (!endpoint) throw new Error(`Endpoint ${endpointId} 不存在`);
-      const permissions: any = {};
-      for (const [k, v] of Object.entries(perms)) {
-        if (typeof v === 'boolean') permissions[k] = v;
-      }
-      const success = await endpoint.setChatPermissionsAll(Number(chat_id), permissions);
-      return { success, message: success ? '群权限已更新' : '操作失败' };
-    },
-  }, plugin.name));
-
-  disposers.push(toolService.addTool({
-    name: 'telegram_set_description',
-    description: '设置 Telegram 群组描述',
-    parameters: {
-      type: 'object',
-      properties: {
-        endpoint_id: { type: 'string', description: 'Endpoint 名称', contextKey: 'endpointId' },
-        chat_id: { type: 'string', description: '聊天 ID' },
-        description: { type: 'string', description: '群描述文字' },
-      },
-      required: ['endpoint_id', 'chat_id', 'description'],
+      return endpoint;
     },
-    platforms: ['telegram'],
-    tags: ['telegram'],
-    execute: async (args: Record<string, any>) => {
-      const endpoint = telegram.endpoints.get(args.endpoint_id);
-      if (!endpoint) throw new Error(`Endpoint ${args.endpoint_id} 不存在`);
-      const success = await endpoint.setChatDescription(Number(args.chat_id), args.description);
-      return { success, message: success ? '群描述已更新' : '操作失败' };
-    },
-  }, plugin.name));
+    getAdapter: () => telegram,
+  });
+  const sceneTools = createSceneManagementTools(
+    telegram as unknown as ISceneManagement,
+    'telegram',
+    { permitResolver: telegramGroupPermitResolver, registerChecker: false },
+  );
+  disposers.push(...sceneTools.map(t => toolService.addTool(t, plugin.name)));
 
   return () => disposers.forEach(d => d());
 });

package/src/platform-permit.ts

@@ -1,8 +1,7 @@
 /**
  * Telegram platform permit — ChatMember 状态 + 细粒度权限
  */
-import type { Message } from 'zhin.js';
-import { registerPlatformPermitChecker } from 'zhin.js';
+import { registerPlatformPermitChecker, type Message } from 'zhin.js';
 
 const ADAPTER = 'telegram';
 
@@ -11,8 +10,8 @@ export function platformPermit(perm: string): string {
 }
 
 const FACTORY_PERM_MAP: Record<string, string> = {
-  group_admin: 'chat_administrator',
-  group_owner: 'chat_creator',
+  scene_admin: 'chat_administrator',
+  scene_owner: 'chat_creator',
 };
 
 export function telegramGroupPermitResolver(logicalPerm: string): string {

package/src/segment-mapper.ts

@@ -0,0 +1 @@
+export { toCanonicalSegments, fromCanonicalSegments } from 'zhin.js';

package/src/telegram-agent-deps.ts

@@ -0,0 +1,22 @@
+/**
+ * Shared runtime deps for telegram agent/ authoring tools.
+ * Set once from plugin index during init — never call getPlugin() from tool execute.
+ */
+import type { TelegramAdapter } from './adapter.js';
+import type { TelegramEndpoint } from './endpoint.js';
+
+export interface TelegramAgentDeps {
+  getEndpoint: (endpointId: string) => TelegramEndpoint;
+  getAdapter: () => TelegramAdapter;
+}
+
+let _deps: TelegramAgentDeps | null = null;
+
+export function setTelegramAgentDeps(deps: TelegramAgentDeps): void {
+  _deps = deps;
+}
+
+export function getTelegramAgentDeps(): TelegramAgentDeps {
+  if (!_deps) throw new Error('telegram agent deps not initialized');
+  return _deps;
+}

package/lib/adapter.d.ts

@@ -1,20 +0,0 @@
-/**
- * Telegram 适配器
- */
-import { Adapter, Plugin } from 'zhin.js';
-import { TelegramEndpoint } from "./endpoint.js";
-import type { TelegramEndpointConfig } from "./types.js";
-export declare class TelegramAdapter extends Adapter<TelegramEndpoint> {
-    static readonly capabilities: readonly ["inbound", "outbound"];
-    static outboundRichSegmentPolicy: import("zhin.js").OutboundRichSegmentPolicy;
-    constructor(plugin: Plugin);
-    createEndpoint(config: TelegramEndpointConfig): TelegramEndpoint;
-    kickMember(endpointId: string, sceneId: string, userId: string): Promise<boolean>;
-    unbanMember(endpointId: string, sceneId: string, userId: string): Promise<boolean>;
-    muteMember(endpointId: string, sceneId: string, userId: string, duration?: number): Promise<boolean>;
-    setAdmin(endpointId: string, sceneId: string, userId: string, enable?: boolean): Promise<boolean>;
-    setGroupName(endpointId: string, sceneId: string, name: string): Promise<boolean>;
-    getGroupInfo(endpointId: string, sceneId: string): Promise<any>;
-    start(): Promise<void>;
-}
-//# sourceMappingURL=adapter.d.ts.map

package/lib/adapter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,OAAO,EACd,MAAM,EAAwC,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD,qBAAa,eAAgB,SAAQ,OAAO,CAAC,gBAAgB,CAAC;IAC5D,gBAAyB,YAAY,mCAAoC;IACzE,OAAgB,yBAAyB,8CAAwC;gBAErE,MAAM,EAAE,MAAM;IAI1B,cAAc,CAAC,MAAM,EAAE,sBAAsB,GAAG,gBAAgB;IAM1D,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAM9D,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAM/D,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,SAAM;IAM9E,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,UAAO;IAM3E,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAM9D,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAQhD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/lib/adapter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"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"}