@zhin.js/adapter-telegram 7.0.14 → 8.0.1

package/CHANGELOG.md

@@ -1,5 +1,40 @@
 # Changelog
 
+## 8.0.1
+
+### Patch Changes
+
+- 1fc78bc: Unify native platform Client access behind the literal `adapter` discriminant. Handlers infer both native events and Clients, while command, inbound/outbound middleware, and both Agent tool authoring surfaces expose the exact operation-scoped Client through a lazy `$client` getter. Definitions without `adapter` keep `$client` typed as `unknown`, and runtime dispatch rejects adapter mismatches before resolving the Client. Bundled platform tools now use this single path instead of model-provided endpoint ids and adapter-specific dependency wrappers. Every adapter registers one Client/EventMap contract, and protocol adapters including NapCat, Milky, OneBot and Satori now produce transport-independent Client objects rather than letting Endpoint instances impersonate Clients.
+- Updated dependencies [e9c6a73]
+- Updated dependencies [4e8117c]
+- Updated dependencies [902fa35]
+- Updated dependencies [54bfd6b]
+- Updated dependencies [12025ee]
+- Updated dependencies [09b14d6]
+- Updated dependencies [1fc78bc]
+  - @zhin.js/agent@1.1.16
+  - @zhin.js/adapter@1.2.1
+  - @zhin.js/core@1.5.14
+  - @zhin.js/host-http@1.0.13
+  - @zhin.js/command@1.0.16
+  - @zhin.js/logger@1.0.77
+  - zhin.js@6.0.14
+  - @zhin.js/feature-kit@1.0.13
+  - @zhin.js/permission@1.0.4
+
+## 8.0.0
+
+### Patch Changes
+
+- Updated dependencies [b10d058]
+- Updated dependencies [f2c532f]
+- Updated dependencies [3dbf990]
+  - @zhin.js/host-http@1.0.12
+  - @zhin.js/adapter@1.2.0
+  - @zhin.js/core@1.5.13
+  - @zhin.js/agent@1.1.15
+  - zhin.js@6.0.13
+
 ## 7.0.14
 
 ### Patch Changes

package/README.md

@@ -20,7 +20,7 @@ pnpm add @zhin.js/adapter-telegram
 ## Plugin Runtime
 
 - `@zhin.js/adapter` — 约定式 `adapters/telegram.ts`（`defineAdapter`）
-- `@zhin.js/core` — `messageGatewayToken` 入站/出站
+- `@zhin.js/core` — `Endpoint.emit(...)` 入站、`outboundMessageToken` 出站
 - `zhin.js` — `plugin.ts`（`definePlugin`）
 - 配置经插件 `schema.json` 落到 `plugins.<instanceKey>`
 - **无需** `@zhin.js/host-http`（polling 路径）

package/adapters/telegram.js

@@ -3,7 +3,6 @@
  * Convention entry: discover `adapters/telegram.ts` → defineAdapter.
  */
 import { defineAdapter } from 'zhin.js/adapter';
-import { messageGatewayToken, sideEventGatewayToken } from '@zhin.js/core/runtime';
 import { httpHostToken } from '@zhin.js/host-http';
 import { TelegramEndpoint } from "../lib/endpoint.js";
 import { resolveTelegramConfig, } from "../lib/protocol.js";
@@ -28,8 +27,6 @@ export default defineAdapter({
         });
         return new TelegramEndpoint({
             id: context.id,
-            gateway: context.use(messageGatewayToken),
-            sideEvents: context.use(sideEventGatewayToken),
             config,
             http: config.mode === 'webhook' ? context.use(httpHostToken) : undefined,
         });

package/adapters/telegram.ts

@@ -2,7 +2,6 @@
  * Convention entry: discover `adapters/telegram.ts` → defineAdapter.
  */
 import { defineAdapter } from 'zhin.js/adapter';
-import { messageGatewayToken, sideEventGatewayToken } from '@zhin.js/core/runtime';
 import { httpHostToken } from '@zhin.js/host-http';
 import { TelegramEndpoint } from '../src/endpoint.js';
 import {
@@ -33,8 +32,6 @@ export default defineAdapter<TelegramAdapterConfig>({
     });
     return new TelegramEndpoint({
       id: context.id,
-      gateway: context.use(messageGatewayToken),
-      sideEvents: context.use(sideEventGatewayToken),
       config,
       http: config.mode === 'webhook' ? context.use(httpHostToken) : undefined,
     });

package/agent/tools/create_invite.ts

@@ -1,19 +1,17 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
 import { platformPermit } from '../../src/platform-permit.js';
-import { getTelegramAgentDeps } from '../../src/telegram-agent-deps.js';
 
-export default defineAgentTool<{ endpoint_id: string; chat_id: string }>({
+export default defineAgentTool<{ chat_id: string }>({
   description: '创建 Telegram 群组邀请链接',
   inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint 名称'),
     chat_id: z.string().describe('聊天 ID'),
   }),
-  platforms: ['telegram'],
+  adapter: 'telegram',
   tags: ['telegram'],
   permissions: [platformPermit('chat_administrator')],
-  async execute({ endpoint_id, chat_id  }: { endpoint_id: string; chat_id: string }) {
-    const endpoint = getTelegramAgentDeps().getEndpoint(endpoint_id);
+  async execute({ chat_id  }: { chat_id: string }, context) {
+    const endpoint = context.$client;
     const link = await endpoint.createInviteLink(Number(chat_id));
     return { invite_link: link, message: `邀请链接: ${link}` };
   },

package/agent/tools/list_admins.ts

@@ -1,17 +1,15 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
-import { getTelegramAgentDeps } from '../../src/telegram-agent-deps.js';
 
-export default defineAgentTool<{ endpoint_id: string; chat_id: string }>({
+export default defineAgentTool<{ chat_id: string }>({
   description: '获取 Telegram 群组管理员列表',
   inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint 名称'),
     chat_id: z.string().describe('聊天 ID'),
   }),
-  platforms: ['telegram'],
+  adapter: 'telegram',
   tags: ['telegram'],
-  async execute({ endpoint_id, chat_id  }: { endpoint_id: string; chat_id: string }) {
-    const endpoint = getTelegramAgentDeps().getEndpoint(endpoint_id);
+  async execute({ chat_id  }: { chat_id: string }, context) {
+    const endpoint = context.$client;
     const admins = await endpoint.getChatAdmins(Number(chat_id));
     return {
       admins: admins.map((a: { user: { id: number; username?: string; first_name?: string }; status: string }) => ({

package/agent/tools/member_count.ts

@@ -1,17 +1,15 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
-import { getTelegramAgentDeps } from '../../src/telegram-agent-deps.js';
 
-export default defineAgentTool<{ endpoint_id: string; chat_id: string }>({
+export default defineAgentTool<{ chat_id: string }>({
   description: '获取 Telegram 群组成员数量',
   inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint 名称'),
     chat_id: z.string().describe('聊天 ID'),
   }),
-  platforms: ['telegram'],
+  adapter: 'telegram',
   tags: ['telegram'],
-  async execute({ endpoint_id, chat_id  }: { endpoint_id: string; chat_id: string }) {
-    const endpoint = getTelegramAgentDeps().getEndpoint(endpoint_id);
+  async execute({ chat_id  }: { chat_id: string }, context) {
+    const endpoint = context.$client;
     const count = await endpoint.getChatMemberCount(Number(chat_id));
     return { count, message: `群组共有 ${count} 名成员` };
   },

package/agent/tools/pin_message.ts

@@ -1,20 +1,18 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
 import { platformPermit } from '../../src/platform-permit.js';
-import { getTelegramAgentDeps } from '../../src/telegram-agent-deps.js';
 
-export default defineAgentTool<{ endpoint_id: string; chat_id: string; message_id: string }>({
+export default defineAgentTool<{ chat_id: string; message_id: string }>({
   description: '置顶 Telegram 群组消息',
   inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint 名称'),
     chat_id: z.string().describe('聊天 ID'),
     message_id: z.string().describe('消息 ID'),
   }),
-  platforms: ['telegram'],
+  adapter: 'telegram',
   tags: ['telegram'],
   permissions: [platformPermit('pin_messages')],
-  async execute({ endpoint_id, chat_id, message_id  }: { endpoint_id: string; chat_id: string; message_id: string }) {
-    const endpoint = getTelegramAgentDeps().getEndpoint(endpoint_id);
+  async execute({ chat_id, message_id  }: { chat_id: string; message_id: string }, context) {
+    const endpoint = context.$client;
     const success = await endpoint.pinMessage(Number(chat_id), Number(message_id));
     return { success, message: success ? '消息已置顶' : '操作失败' };
   },

package/agent/tools/react.ts

@@ -1,19 +1,17 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
-import { getTelegramAgentDeps } from '../../src/telegram-agent-deps.js';
 
-export default defineAgentTool<{ endpoint_id: string; chat_id: string; message_id: string; reaction: string }>({
+export default defineAgentTool<{ chat_id: string; message_id: string; reaction: string }>({
   description: '对 Telegram 消息添加表情反应',
   inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint 名称'),
     chat_id: z.string().describe('聊天 ID'),
     message_id: z.string().describe('消息 ID'),
     reaction: z.string().describe('反应表情（如 👍、❤️、🔥）'),
   }),
-  platforms: ['telegram'],
+  adapter: 'telegram',
   tags: ['telegram'],
-  async execute({ endpoint_id, chat_id, message_id, reaction  }: { endpoint_id: string; chat_id: string; message_id: string; reaction: string }) {
-    const endpoint = getTelegramAgentDeps().getEndpoint(endpoint_id);
+  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);
     return { success, message: success ? `已添加反应 ${reaction}` : '操作失败' };
   },

package/agent/tools/send_poll.ts

@@ -1,21 +1,19 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
-import { getTelegramAgentDeps } from '../../src/telegram-agent-deps.js';
 
-export default defineAgentTool<{ endpoint_id: string; chat_id: string; question: string; options: string; is_anonymous?: boolean; allows_multiple?: boolean }>({
+export default defineAgentTool<{ chat_id: string; question: string; options: string; is_anonymous?: boolean; allows_multiple?: boolean }>({
   description: '在 Telegram 群组中发起投票',
   inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint 名称'),
     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'),
     allows_multiple: z.boolean().optional().describe('是否允许多选，默认 false'),
   }),
-  platforms: ['telegram'],
+  adapter: 'telegram',
   tags: ['telegram'],
-  async execute({ endpoint_id, chat_id, question, options, is_anonymous, allows_multiple  }: { endpoint_id: string; chat_id: string; question: string; options: string; is_anonymous?: boolean; allows_multiple?: boolean }) {
-    const endpoint = getTelegramAgentDeps().getEndpoint(endpoint_id);
+  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;
     let optList: string[];
     try {
       optList = JSON.parse(options);

package/agent/tools/send_sticker.ts

@@ -1,18 +1,16 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
-import { getTelegramAgentDeps } from '../../src/telegram-agent-deps.js';
 
-export default defineAgentTool<{ endpoint_id: string; chat_id: string; sticker: string }>({
+export default defineAgentTool<{ chat_id: string; sticker: string }>({
   description: '发送 Telegram 贴纸',
   inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint 名称'),
     chat_id: z.string().describe('聊天 ID'),
     sticker: z.string().describe('贴纸 file_id 或 URL'),
   }),
-  platforms: ['telegram'],
+  adapter: 'telegram',
   tags: ['telegram'],
-  async execute({ endpoint_id, chat_id, sticker  }: { endpoint_id: string; chat_id: string; sticker: string }) {
-    const endpoint = getTelegramAgentDeps().getEndpoint(endpoint_id);
+  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: '贴纸已发送' };
   },

package/agent/tools/set_description.ts

@@ -1,18 +1,16 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
-import { getTelegramAgentDeps } from '../../src/telegram-agent-deps.js';
 
-export default defineAgentTool<{ endpoint_id: string; chat_id: string; description: string }>({
+export default defineAgentTool<{ chat_id: string; description: string }>({
   description: '设置 Telegram 群组描述',
   inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint 名称'),
     chat_id: z.string().describe('聊天 ID'),
     description: z.string().describe('群描述文字'),
   }),
-  platforms: ['telegram'],
+  adapter: 'telegram',
   tags: ['telegram'],
-  async execute({ endpoint_id, chat_id, description  }: { endpoint_id: string; chat_id: string; description: string }) {
-    const endpoint = getTelegramAgentDeps().getEndpoint(endpoint_id);
+  async execute({ chat_id, description  }: { chat_id: string; description: string }, context) {
+    const endpoint = context.$client;
     const success = await endpoint.setChatDescription(Number(chat_id), description);
     return { success, message: success ? '群描述已更新' : '操作失败' };
   },

package/agent/tools/set_permissions.ts

@@ -1,12 +1,10 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
 import { platformPermit } from '../../src/platform-permit.js';
-import { getTelegramAgentDeps } from '../../src/telegram-agent-deps.js';
 
-export default defineAgentTool<{ endpoint_id: string; 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 }>({
+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 群组的默认成员权限',
   inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint 名称'),
     chat_id: z.string().describe('聊天 ID'),
     can_send_messages: z.boolean().optional().describe('是否可以发消息'),
     can_send_photos: z.boolean().optional().describe('是否可以发图片'),
@@ -18,11 +16,11 @@ export default defineAgentTool<{ endpoint_id: string; chat_id: string; can_send_
     can_invite_users: z.boolean().optional().describe('是否可以邀请用户'),
     can_pin_messages: z.boolean().optional().describe('是否可以置顶消息'),
   }),
-  platforms: ['telegram'],
+  adapter: 'telegram',
   tags: ['telegram'],
   permissions: [platformPermit('manage_chat')],
-  async execute({ endpoint_id, chat_id, ...perms  }: { endpoint_id: string; 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 }) {
-    const endpoint = getTelegramAgentDeps().getEndpoint(endpoint_id);
+  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) {
+    const endpoint = context.$client;
     const permissions: Record<string, boolean> = {};
     for (const [k, v] of Object.entries(perms)) {
       if (typeof v === 'boolean') permissions[k] = v;

package/agent/tools/unpin_message.ts

@@ -1,20 +1,18 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
 import { platformPermit } from '../../src/platform-permit.js';
-import { getTelegramAgentDeps } from '../../src/telegram-agent-deps.js';
 
-export default defineAgentTool<{ endpoint_id: string; chat_id: string; message_id?: string }>({
+export default defineAgentTool<{ chat_id: string; message_id?: string }>({
   description: '取消置顶 Telegram 群组消息',
   inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint 名称'),
     chat_id: z.string().describe('聊天 ID'),
     message_id: z.string().optional().describe('消息 ID（可选，不提供则取消所有置顶）'),
   }),
-  platforms: ['telegram'],
+  adapter: 'telegram',
   tags: ['telegram'],
   permissions: [platformPermit('pin_messages')],
-  async execute({ endpoint_id, chat_id, message_id  }: { endpoint_id: string; chat_id: string; message_id?: string }) {
-    const endpoint = getTelegramAgentDeps().getEndpoint(endpoint_id);
+  async execute({ chat_id, message_id  }: { chat_id: string; message_id?: string }, context) {
+    const endpoint = context.$client;
     const success = await endpoint.unpinMessage(Number(chat_id), message_id ? Number(message_id) : undefined);
     return { success, message: success ? '已取消置顶' : '操作失败' };
   },

package/lib/client.d.ts

@@ -0,0 +1,12 @@
+import type { TelegramClient } from './endpoint.js';
+import type { TelegramUpdate } from './protocol.js';
+export type TelegramClientEventMap = Record<string, TelegramUpdate>;
+declare module '@zhin.js/feature-kit' {
+    interface AdapterClientRegistry {
+        readonly telegram: {
+            readonly client: TelegramClient;
+            readonly events: TelegramClientEventMap;
+        };
+    }
+}
+export declare const telegramClient: import("@zhin.js/adapter").EndpointClientToken<TelegramClient, TelegramClientEventMap>;

package/lib/client.js

@@ -0,0 +1,2 @@
+import { defineEndpointClient } from 'zhin.js/adapter';
+export const telegramClient = defineEndpointClient('telegram');

package/lib/endpoint.d.ts

@@ -1,5 +1,5 @@
-import type { EndpointContentPort, EndpointControl, EndpointInstance, EndpointSendRequest } from 'zhin.js/adapter';
-import type { MessageGateway, SideEventGateway } from '@zhin.js/core/runtime';
+import { Endpoint } from 'zhin.js/adapter';
+import type { EndpointContentPort, EndpointControl, EndpointSendRequest } from 'zhin.js/adapter';
 import type { HttpHost } from '@zhin.js/host-http';
 import { type MessageRef } from '@zhin.js/im-contract';
 import type { CapabilityId } from 'zhin.js';
@@ -21,19 +21,57 @@ export type TelegramFetch = (url: string, init?: {
 }>;
 export interface TelegramEndpointOptions {
     readonly id: CapabilityId;
-    readonly gateway: MessageGateway;
-    readonly sideEvents?: SideEventGateway;
     readonly config: ResolvedTelegramConfig;
     readonly http?: HttpHost;
     readonly fetch?: TelegramFetch;
 }
+export interface TelegramClientApi {
+    callApi<T = unknown>(method: string, params?: Record<string, unknown>): Promise<T>;
+    callApiForm<T = unknown>(method: string, form: FormData): Promise<T>;
+    pinMessage(chatId: number, messageId: number): Promise<boolean>;
+    unpinMessage(chatId: number, messageId?: number): Promise<boolean>;
+    setChatDescription(chatId: number, description: string): Promise<boolean>;
+    setMessageReaction(chatId: number, messageId: number, reaction: string): Promise<boolean>;
+    getChatMemberCount(chatId: number): Promise<number>;
+    getChatAdmins(chatId: number): Promise<TelegramChatMember[]>;
+    sendStickerMessage(chatId: number, sticker: string): Promise<{
+        message_id: number;
+    }>;
+    setChatPermissionsAll(chatId: number, permissions: Record<string, boolean | undefined>): Promise<boolean>;
+    createInviteLink(chatId: number): Promise<string>;
+    sendPoll(chatId: number, question: string, options: string[], isAnonymous?: boolean, allowsMultipleAnswers?: boolean): Promise<{
+        message_id: number;
+    }>;
+}
+/** Telegram Bot API client carried by message, update and lifecycle events. */
+export declare class TelegramClient implements TelegramClientApi {
+    readonly api: TelegramClientApi;
+    constructor(api: TelegramClientApi);
+    callApi: <T = unknown>(method: string, params?: Record<string, unknown>) => Promise<T>;
+    callApiForm: <T = unknown>(method: string, form: FormData) => Promise<T>;
+    pinMessage: (chatId: number, messageId: number) => Promise<boolean>;
+    unpinMessage: (chatId: number, messageId?: number) => Promise<boolean>;
+    setChatDescription: (chatId: number, description: string) => Promise<boolean>;
+    setMessageReaction: (chatId: number, messageId: number, reaction: string) => Promise<boolean>;
+    getChatMemberCount: (chatId: number) => Promise<number>;
+    getChatAdmins: (chatId: number) => Promise<TelegramChatMember[]>;
+    sendStickerMessage: (chatId: number, sticker: string) => Promise<{
+        message_id: number;
+    }>;
+    setChatPermissionsAll: (chatId: number, permissions: Record<string, boolean | undefined>) => Promise<boolean>;
+    createInviteLink: (chatId: number) => Promise<string>;
+    sendPoll: (chatId: number, question: string, options: string[], anonymous?: boolean, multiple?: boolean) => Promise<{
+        message_id: number;
+    }>;
+}
 /**
  * Telegram Bot API 无列表类接口（无 getMyChats/getChatMembers），
  * 仅 getChat/getChatMember 按已知 id 单查，不构成列表能力；
  * 因此本 endpoint 不暴露 EndpointManagement（Console 社交面 RPC 对该平台保持未接线）。
  */
-export declare class TelegramEndpoint implements EndpointInstance {
+export declare class TelegramEndpoint extends Endpoint<TelegramClient> {
     #private;
+    readonly client: TelegramClient;
     readonly control: EndpointControl;
     readonly content: EndpointContentPort;
     constructor(options: TelegramEndpointOptions);

package/lib/endpoint.js

@@ -1,3 +1,4 @@
+import { Endpoint } from 'zhin.js/adapter';
 /**
  * TelegramEndpoint — lifecycle, outbound, admit, Bot API helpers for agent tools.
  */
@@ -6,16 +7,48 @@ import { formatCompact, getAdapterLogger } from '@zhin.js/logger';
 import { runTelegramPollLoop } from './polling.js';
 import { normalizeTelegramChatMember } from './platform-permit.js';
 import { botApiUrl, buildWebhookUrl, formatCallbackContent, formatCallbackSegments, formatInboundContent, formatInboundSegments, formatOutboundPlan, resolveTelegramChannelType, senderDisplayName, telegramInboundConversation, } from './protocol.js';
-import { registerTelegramAgentEndpoint } from './telegram-agent-deps.js';
 import { registerTelegramWebhookRoutes } from './webhook.js';
 const CHAT_MEMBER_CACHE_TTL_MS = 60_000;
 const CHAT_MEMBER_CACHE_MAX = 2_000;
+/** Telegram Bot API client carried by message, update and lifecycle events. */
+export class TelegramClient {
+    api;
+    constructor(api) {
+        this.api = api;
+    }
+    callApi = (method, params = {}) => this.api.callApi(method, params);
+    callApiForm = (method, form) => this.api.callApiForm(method, form);
+    pinMessage = (chatId, messageId) => this.api.pinMessage(chatId, messageId);
+    unpinMessage = (chatId, messageId) => this.api.unpinMessage(chatId, messageId);
+    setChatDescription = (chatId, description) => this.api.setChatDescription(chatId, description);
+    setMessageReaction = (chatId, messageId, reaction) => this.api.setMessageReaction(chatId, messageId, reaction);
+    getChatMemberCount = (chatId) => this.api.getChatMemberCount(chatId);
+    getChatAdmins = (chatId) => this.api.getChatAdmins(chatId);
+    sendStickerMessage = (chatId, sticker) => this.api.sendStickerMessage(chatId, sticker);
+    setChatPermissionsAll = (chatId, permissions) => this.api.setChatPermissionsAll(chatId, permissions);
+    createInviteLink = (chatId) => this.api.createInviteLink(chatId);
+    sendPoll = (chatId, question, options, anonymous, multiple) => this.api.sendPoll(chatId, question, options, anonymous, multiple);
+}
 /**
  * Telegram Bot API 无列表类接口（无 getMyChats/getChatMembers），
  * 仅 getChat/getChatMember 按已知 id 单查，不构成列表能力；
  * 因此本 endpoint 不暴露 EndpointManagement（Console 社交面 RPC 对该平台保持未接线）。
  */
-export class TelegramEndpoint {
+export class TelegramEndpoint extends Endpoint {
+    client = new TelegramClient({
+        callApi: (method, params) => this.callApi(method, params),
+        callApiForm: (method, form) => this.callApiForm(method, form),
+        pinMessage: (chatId, messageId) => this.pinMessage(chatId, messageId),
+        unpinMessage: (chatId, messageId) => this.unpinMessage(chatId, messageId),
+        setChatDescription: (chatId, description) => this.setChatDescription(chatId, description),
+        setMessageReaction: (chatId, messageId, reaction) => this.setMessageReaction(chatId, messageId, reaction),
+        getChatMemberCount: (chatId) => this.getChatMemberCount(chatId),
+        getChatAdmins: (chatId) => this.getChatAdmins(chatId),
+        sendStickerMessage: (chatId, sticker) => this.sendStickerMessage(chatId, sticker),
+        setChatPermissionsAll: (chatId, permissions) => this.setChatPermissionsAll(chatId, permissions),
+        createInviteLink: (chatId) => this.createInviteLink(chatId),
+        sendPoll: (chatId, question, options, anonymous, multiple) => this.sendPoll(chatId, question, options, anonymous, multiple),
+    });
     #logger;
     #options;
     #fetch;
@@ -24,7 +57,6 @@ export class TelegramEndpoint {
     #routeReleases = [];
     #open = false;
     #started = false;
-    #unregisterAgent;
     #updateOffset = 0;
     #botUserId;
     #botUsername;
@@ -36,6 +68,7 @@ export class TelegramEndpoint {
         resolve: (reference, context) => this.#resolveContent(reference, context.signal),
     });
     constructor(options) {
+        super();
         this.#logger = getAdapterLogger('telegram', options.config.id);
         this.#options = options;
         this.#fetch = options.fetch ?? globalThis.fetch;
@@ -61,7 +94,6 @@ export class TelegramEndpoint {
             return;
         this.#started = true;
         try {
-            this.#unregisterAgent = registerTelegramAgentEndpoint(this.#options.config.id, this);
             const me = await this.callApi('getMe');
             this.#botUserId = me.id;
             this.#botUsername = me.username;
@@ -128,8 +160,6 @@ export class TelegramEndpoint {
         }
         for (const release of this.#routeReleases.splice(0))
             release();
-        this.#unregisterAgent?.();
-        this.#unregisterAgent = undefined;
         this.#chatMemberCache.clear();
         this.#started = false;
         this.#logger.debug(formatCompact({ op: 'disconnect' }));
@@ -243,7 +273,7 @@ export class TelegramEndpoint {
         const permit = await this.#resolveGroupSenderPermit(msg);
         // 新 Runtime Message.content 为纯文本：@ 本机只能经 metadata 传递
         const mentioned = this.#isBotMentioned(msg);
-        await this.#options.gateway.receive({
+        await this.emit('message.receive', {
             conversation,
             message: { conversation, id: String(msg.message_id) },
             content: formatInboundContent(msg),
@@ -336,7 +366,7 @@ export class TelegramEndpoint {
         const conversation = msg
             ? telegramInboundConversation(endpointKey, msg.chat)
             : telegramInboundConversation(endpointKey, { id: query.from.id, type: 'private' });
-        void this.#options.gateway.receive({
+        void this.emit('message.receive', {
             conversation,
             message: { conversation, id: query.id },
             content: formatCallbackContent(query),
@@ -358,6 +388,18 @@ export class TelegramEndpoint {
     }
     /** Used by webhook / polling handlers. */
     handleUpdate(update) {
+        const eventName = update.message
+            ? 'message'
+            : update.callback_query
+                ? 'callback_query'
+                : 'update';
+        void this.emitPlatform(eventName, update).catch((error) => {
+            this.#logger.warn(formatCompact({
+                op: 'telegram_platform_event_failed',
+                event: eventName,
+                error: error instanceof Error ? error.message : String(error),
+            }));
+        });
         if (update.message) {
             this.admit(update.message);
             return;

package/lib/index.d.ts

@@ -1,4 +1,4 @@
-export { TelegramEndpoint, type TelegramEndpointOptions, type TelegramFetch, } from './endpoint.js';
+export { TelegramClient, TelegramEndpoint, type TelegramClientApi, type TelegramEndpointOptions, type TelegramFetch, } from './endpoint.js';
 export { botApiUrl, formatCallbackContent, formatInboundContent, formatOutboundActions, formatOutboundPlan, normalizeWebhookPath, resolveTelegramConfig, senderDisplayName, type ResolvedTelegramConfig, type TelegramAdapterConfig, type TelegramCallbackQuery, type TelegramChat, type TelegramChatMember, type TelegramMessage, type TelegramOutboundAction, type TelegramOutboundPlan, type TelegramOutboundUpload, type TelegramUpdate, type TelegramUser, type TelegramWireSegment, } from './protocol.js';
-export { getTelegramAgentDeps, registerTelegramAgentEndpoint, setTelegramAgentDeps, type TelegramAgentDeps, type TelegramAgentEndpoint, } from './telegram-agent-deps.js';
+export { telegramClient, type TelegramClientEventMap } from './client.js';
 export { checkTelegramPlatformPermit, normalizeTelegramChatMember, platformPermit, telegramGroupPermitResolver, } from './platform-permit.js';

package/lib/index.js

@@ -1,4 +1,4 @@
-export { TelegramEndpoint, } from './endpoint.js';
+export { TelegramClient, TelegramEndpoint, } from './endpoint.js';
 export { botApiUrl, formatCallbackContent, formatInboundContent, formatOutboundActions, formatOutboundPlan, normalizeWebhookPath, resolveTelegramConfig, senderDisplayName, } from './protocol.js';
-export { getTelegramAgentDeps, registerTelegramAgentEndpoint, setTelegramAgentDeps, } from './telegram-agent-deps.js';
+export { telegramClient } from './client.js';
 export { checkTelegramPlatformPermit, normalizeTelegramChatMember, platformPermit, telegramGroupPermitResolver, } from './platform-permit.js';

package/lib/protocol.d.ts

@@ -251,7 +251,7 @@ export declare function resolveTelegramChannelType(chatType: TelegramChat['type'
  */
 export declare function telegramInboundConversation(endpointKey: string, chat: Pick<TelegramChat, 'id' | 'type'>): ConversationRef;
 export declare function senderDisplayName(user?: TelegramUser): string;
-/** Build inbound text for MessageGateway.receive. */
+/** Build inbound text for OutboundMessageService.receive. */
 export declare function formatInboundContent(msg: TelegramMessage): string;
 export declare function formatCallbackContent(query: TelegramCallbackQuery): string;
 /**

package/lib/protocol.js

@@ -101,7 +101,7 @@ export function senderDisplayName(user) {
         return 'Unknown';
     return user.username || user.first_name || String(user.id);
 }
-/** Build inbound text for MessageGateway.receive. */
+/** Build inbound text for OutboundMessageService.receive. */
 export function formatInboundContent(msg) {
     if (msg.text)
         return msg.text;

package/lib/telegram-endpoint-commands.d.ts

@@ -1 +1 @@
-export declare const telegramEndpointCommands: import("@zhin.js/adapter").EndpointCommands<Readonly<import("@zhin.js/command").CommandDefinition<unknown, unknown, import("@zhin.js/command").CommandMessage>>>;
+export declare const telegramEndpointCommands: import("@zhin.js/adapter").EndpointCommands<Readonly<import("@zhin.js/command").CommandDefinition<unknown, unknown, import("@zhin.js/command").CommandMessage, string | undefined>>>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-telegram",
-  "version": "7.0.14",
+  "version": "8.0.1",
   "description": "Zhin.js Telegram Bot API adapter for Plugin Runtime (long-poll getUpdates)",
   "type": "module",
   "main": "./lib/index.js",
@@ -32,20 +32,21 @@
     "directory": "plugins/adapters/telegram"
   },
   "dependencies": {
-    "@zhin.js/adapter": "1.1.11",
-    "@zhin.js/core": "1.5.12",
-    "@zhin.js/host-http": "1.0.11",
+    "@zhin.js/adapter": "1.2.1",
+    "@zhin.js/core": "1.5.14",
+    "@zhin.js/feature-kit": "1.0.13",
+    "@zhin.js/host-http": "1.0.13",
     "@zhin.js/im-contract": "1.0.4",
-    "@zhin.js/logger": "1.0.76"
+    "@zhin.js/logger": "1.0.77"
   },
   "peerDependencies": {
     "zod": "^4.0.0",
-    "@zhin.js/adapter": "1.1.11",
-    "@zhin.js/agent": "1.1.14",
-    "@zhin.js/command": "1.0.15",
-    "@zhin.js/core": "1.5.12",
-    "@zhin.js/permission": "1.0.3",
-    "zhin.js": "6.0.12"
+    "@zhin.js/adapter": "1.2.1",
+    "@zhin.js/agent": "1.1.16",
+    "@zhin.js/command": "1.0.16",
+    "@zhin.js/core": "1.5.14",
+    "@zhin.js/permission": "1.0.4",
+    "zhin.js": "6.0.14"
   },
   "peerDependenciesMeta": {
     "@zhin.js/agent": {
@@ -66,9 +67,9 @@
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
     "zod": "^4.4.3",
-    "@zhin.js/agent": "1.1.14",
-    "@zhin.js/host-http": "1.0.11",
-    "zhin.js": "6.0.12"
+    "@zhin.js/agent": "1.1.16",
+    "@zhin.js/host-http": "1.0.13",
+    "zhin.js": "6.0.14"
   },
   "files": [
     "adapters",

package/src/client.ts

@@ -0,0 +1,16 @@
+import { defineEndpointClient } from 'zhin.js/adapter';
+import type { TelegramClient } from './endpoint.js';
+import type { TelegramUpdate } from './protocol.js';
+
+export type TelegramClientEventMap = Record<string, TelegramUpdate>;
+
+declare module '@zhin.js/feature-kit' {
+  interface AdapterClientRegistry {
+    readonly telegram: {
+      readonly client: TelegramClient;
+      readonly events: TelegramClientEventMap;
+    };
+  }
+}
+
+export const telegramClient = defineEndpointClient<TelegramClient, TelegramClientEventMap>('telegram');

package/src/endpoint.ts

@@ -1,9 +1,9 @@
+import { Endpoint } from 'zhin.js/adapter';
 /**
  * TelegramEndpoint — lifecycle, outbound, admit, Bot API helpers for agent tools.
  */
 import { readFile } from 'node:fs/promises';
-import type { EndpointContentPort, EndpointContentResolveContext, EndpointControl, EndpointInstance, EndpointSendRequest } from 'zhin.js/adapter';
-import type { MessageGateway, SideEventGateway } from '@zhin.js/core/runtime';
+import type { EndpointContentPort, EndpointContentResolveContext, EndpointControl, EndpointSendRequest } from 'zhin.js/adapter';
 import type { HttpHost, HttpRouteRegistration } from '@zhin.js/host-http';
 import {
   type ConversationRef,
@@ -33,7 +33,6 @@ import {
   type TelegramOutboundUpload,
   type TelegramUpdate,
 } from './protocol.js';
-import { registerTelegramAgentEndpoint } from './telegram-agent-deps.js';
 import { registerTelegramWebhookRoutes } from './webhook.js';
 
 const CHAT_MEMBER_CACHE_TTL_MS = 60_000;
@@ -64,13 +63,61 @@ export type TelegramFetch = (
 
 export interface TelegramEndpointOptions {
   readonly id: CapabilityId;
-  readonly gateway: MessageGateway;
-  readonly sideEvents?: SideEventGateway;
   readonly config: ResolvedTelegramConfig;
   readonly http?: HttpHost;
   readonly fetch?: TelegramFetch;
 }
 
+export interface TelegramClientApi {
+  callApi<T = unknown>(method: string, params?: Record<string, unknown>): Promise<T>;
+  callApiForm<T = unknown>(method: string, form: FormData): Promise<T>;
+  pinMessage(chatId: number, messageId: number): Promise<boolean>;
+  unpinMessage(chatId: number, messageId?: number): Promise<boolean>;
+  setChatDescription(chatId: number, description: string): Promise<boolean>;
+  setMessageReaction(chatId: number, messageId: number, reaction: string): Promise<boolean>;
+  getChatMemberCount(chatId: number): Promise<number>;
+  getChatAdmins(chatId: number): Promise<TelegramChatMember[]>;
+  sendStickerMessage(chatId: number, sticker: string): Promise<{ message_id: number }>;
+  setChatPermissionsAll(chatId: number, permissions: Record<string, boolean | undefined>): Promise<boolean>;
+  createInviteLink(chatId: number): Promise<string>;
+  sendPoll(
+    chatId: number,
+    question: string,
+    options: string[],
+    isAnonymous?: boolean,
+    allowsMultipleAnswers?: boolean,
+  ): Promise<{ message_id: number }>;
+}
+
+/** Telegram Bot API client carried by message, update and lifecycle events. */
+export class TelegramClient implements TelegramClientApi {
+  constructor(readonly api: TelegramClientApi) {}
+  callApi = <T = unknown>(method: string, params: Record<string, unknown> = {}) =>
+    this.api.callApi<T>(method, params);
+  callApiForm = <T = unknown>(method: string, form: FormData) =>
+    this.api.callApiForm<T>(method, form);
+  pinMessage = (chatId: number, messageId: number) => this.api.pinMessage(chatId, messageId);
+  unpinMessage = (chatId: number, messageId?: number) => this.api.unpinMessage(chatId, messageId);
+  setChatDescription = (chatId: number, description: string) =>
+    this.api.setChatDescription(chatId, description);
+  setMessageReaction = (chatId: number, messageId: number, reaction: string) =>
+    this.api.setMessageReaction(chatId, messageId, reaction);
+  getChatMemberCount = (chatId: number) => this.api.getChatMemberCount(chatId);
+  getChatAdmins = (chatId: number) => this.api.getChatAdmins(chatId);
+  sendStickerMessage = (chatId: number, sticker: string) =>
+    this.api.sendStickerMessage(chatId, sticker);
+  setChatPermissionsAll = (chatId: number, permissions: Record<string, boolean | undefined>) =>
+    this.api.setChatPermissionsAll(chatId, permissions);
+  createInviteLink = (chatId: number) => this.api.createInviteLink(chatId);
+  sendPoll = (
+    chatId: number,
+    question: string,
+    options: string[],
+    anonymous?: boolean,
+    multiple?: boolean,
+  ) => this.api.sendPoll(chatId, question, options, anonymous, multiple);
+}
+
 interface TelegramApiOk<T> {
   readonly ok: true;
   readonly result: T;
@@ -87,7 +134,24 @@ interface TelegramApiErr {
  * 仅 getChat/getChatMember 按已知 id 单查，不构成列表能力；
  * 因此本 endpoint 不暴露 EndpointManagement（Console 社交面 RPC 对该平台保持未接线）。
  */
-export class TelegramEndpoint implements EndpointInstance {
+export class TelegramEndpoint extends Endpoint<TelegramClient> {
+  readonly client = new TelegramClient({
+    callApi: (method, params) => this.callApi(method, params),
+    callApiForm: (method, form) => this.callApiForm(method, form),
+    pinMessage: (chatId, messageId) => this.pinMessage(chatId, messageId),
+    unpinMessage: (chatId, messageId) => this.unpinMessage(chatId, messageId),
+    setChatDescription: (chatId, description) => this.setChatDescription(chatId, description),
+    setMessageReaction: (chatId, messageId, reaction) =>
+      this.setMessageReaction(chatId, messageId, reaction),
+    getChatMemberCount: (chatId) => this.getChatMemberCount(chatId),
+    getChatAdmins: (chatId) => this.getChatAdmins(chatId),
+    sendStickerMessage: (chatId, sticker) => this.sendStickerMessage(chatId, sticker),
+    setChatPermissionsAll: (chatId, permissions) =>
+      this.setChatPermissionsAll(chatId, permissions),
+    createInviteLink: (chatId) => this.createInviteLink(chatId),
+    sendPoll: (chatId, question, options, anonymous, multiple) =>
+      this.sendPoll(chatId, question, options, anonymous, multiple),
+  });
   readonly #logger!: ReturnType<typeof getAdapterLogger>;
 
   readonly #options: TelegramEndpointOptions;
@@ -97,7 +161,6 @@ export class TelegramEndpoint implements EndpointInstance {
   #routeReleases: HttpRouteRegistration[] = [];
   #open = false;
   #started = false;
-  #unregisterAgent?: () => void;
   #updateOffset = 0;
   #botUserId?: number;
   #botUsername?: string;
@@ -110,6 +173,7 @@ export class TelegramEndpoint implements EndpointInstance {
   });
 
   constructor(options: TelegramEndpointOptions) {
+    super();
     this.#logger = getAdapterLogger('telegram', options.config.id);
     this.#options = options;
     this.#fetch = options.fetch ?? globalThis.fetch;
@@ -140,7 +204,6 @@ export class TelegramEndpoint implements EndpointInstance {
     if (this.#started) return;
     this.#started = true;
     try {
-      this.#unregisterAgent = registerTelegramAgentEndpoint(this.#options.config.id, this);
       const me = await this.callApi<{ id?: number; username?: string; first_name?: string }>('getMe');
       this.#botUserId = me.id;
       this.#botUsername = me.username;
@@ -209,8 +272,6 @@ export class TelegramEndpoint implements EndpointInstance {
       /* poll loop exit */
     }
     for (const release of this.#routeReleases.splice(0)) release();
-    this.#unregisterAgent?.();
-    this.#unregisterAgent = undefined;
     this.#chatMemberCache.clear();
     this.#started = false;
     this.#logger.debug(formatCompact({ op: 'disconnect' }));
@@ -330,7 +391,7 @@ export class TelegramEndpoint implements EndpointInstance {
     const permit = await this.#resolveGroupSenderPermit(msg);
     // 新 Runtime Message.content 为纯文本：@ 本机只能经 metadata 传递
     const mentioned = this.#isBotMentioned(msg);
-    await this.#options.gateway.receive({
+    await this.emit('message.receive', {
       conversation,
       message: { conversation, id: String(msg.message_id) },
       content: formatInboundContent(msg),
@@ -417,7 +478,7 @@ export class TelegramEndpoint implements EndpointInstance {
     const conversation = msg
       ? telegramInboundConversation(endpointKey, msg.chat)
       : telegramInboundConversation(endpointKey, { id: query.from.id, type: 'private' });
-    void this.#options.gateway.receive({
+    void this.emit('message.receive', {
       conversation,
       message: { conversation, id: query.id },
       content: formatCallbackContent(query),
@@ -440,6 +501,18 @@ export class TelegramEndpoint implements EndpointInstance {
 
   /** Used by webhook / polling handlers. */
   handleUpdate(update: TelegramUpdate): void {
+    const eventName = update.message
+      ? 'message'
+      : update.callback_query
+        ? 'callback_query'
+        : 'update';
+    void this.emitPlatform(eventName, update).catch((error) => {
+      this.#logger.warn(formatCompact({
+        op: 'telegram_platform_event_failed',
+        event: eventName,
+        error: error instanceof Error ? error.message : String(error),
+      }));
+    });
     if (update.message) {
       this.admit(update.message);
       return;

package/src/index.ts

@@ -1,5 +1,7 @@
 export {
+  TelegramClient,
   TelegramEndpoint,
+  type TelegramClientApi,
   type TelegramEndpointOptions,
   type TelegramFetch,
 } from './endpoint.js';
@@ -27,13 +29,7 @@ export {
   type TelegramWireSegment,
 } from './protocol.js';
 
-export {
-  getTelegramAgentDeps,
-  registerTelegramAgentEndpoint,
-  setTelegramAgentDeps,
-  type TelegramAgentDeps,
-  type TelegramAgentEndpoint,
-} from './telegram-agent-deps.js';
+export { telegramClient, type TelegramClientEventMap } from './client.js';
 
 export {
   checkTelegramPlatformPermit,

package/src/protocol.ts

@@ -358,7 +358,7 @@ export function senderDisplayName(user?: TelegramUser): string {
   return user.username || user.first_name || String(user.id);
 }
 
-/** Build inbound text for MessageGateway.receive. */
+/** Build inbound text for OutboundMessageService.receive. */
 export function formatInboundContent(msg: TelegramMessage): string {
   if (msg.text) return msg.text;
   if (msg.caption) return msg.caption;

package/lib/telegram-agent-deps.d.ts

@@ -1,28 +0,0 @@
-/**
- * Agent tool deps for telegram.
- * Endpoints register themselves on start; tools look up by config name / endpoint id.
- */
-import type { TelegramChatMember } from './protocol.js';
-export interface TelegramAgentEndpoint {
-    pinMessage(chatId: number, messageId: number): Promise<boolean>;
-    unpinMessage(chatId: number, messageId?: number): Promise<boolean>;
-    setChatDescription(chatId: number, description: string): Promise<boolean>;
-    setMessageReaction(chatId: number, messageId: number, reaction: string): Promise<boolean>;
-    getChatMemberCount(chatId: number): Promise<number>;
-    getChatAdmins(chatId: number): Promise<TelegramChatMember[]>;
-    sendStickerMessage(chatId: number, sticker: string): Promise<{
-        message_id: number;
-    }>;
-    setChatPermissionsAll(chatId: number, permissions: Record<string, boolean | undefined>): Promise<boolean>;
-    createInviteLink(chatId: number): Promise<string>;
-    sendPoll(chatId: number, question: string, options: string[], isAnonymous?: boolean, allowsMultipleAnswers?: boolean): Promise<{
-        message_id: number;
-    }>;
-}
-export interface TelegramAgentDeps {
-    getEndpoint: (endpointKey: string) => TelegramAgentEndpoint;
-}
-export declare function registerTelegramAgentEndpoint(endpointKey: string, endpoint: TelegramAgentEndpoint): () => void;
-/** Optional override used by tests / transitional callers. Pass `null` to clear. */
-export declare function setTelegramAgentDeps(deps: TelegramAgentDeps | null): void;
-export declare function getTelegramAgentDeps(): TelegramAgentDeps;

package/lib/telegram-agent-deps.js

@@ -1,30 +0,0 @@
-/**
- * Agent tool deps for telegram.
- * Endpoints register themselves on start; tools look up by config name / endpoint id.
- */
-const endpoints = new Map();
-let override = null;
-export function registerTelegramAgentEndpoint(endpointKey, endpoint) {
-    endpoints.set(endpointKey, endpoint);
-    return () => {
-        if (endpoints.get(endpointKey) === endpoint) {
-            endpoints.delete(endpointKey);
-        }
-    };
-}
-/** Optional override used by tests / transitional callers. Pass `null` to clear. */
-export function setTelegramAgentDeps(deps) {
-    override = deps;
-}
-export function getTelegramAgentDeps() {
-    if (override)
-        return override;
-    return {
-        getEndpoint(endpointKey) {
-            const registered = endpoints.get(endpointKey);
-            if (!registered)
-                throw new Error(`Endpoint ${endpointKey} 不存在`);
-            return registered;
-        },
-    };
-}

package/src/telegram-agent-deps.ts

@@ -1,63 +0,0 @@
-/**
- * Agent tool deps for telegram.
- * Endpoints register themselves on start; tools look up by config name / endpoint id.
- */
-
-import type { TelegramChatMember } from './protocol.js';
-
-export interface TelegramAgentEndpoint {
-  pinMessage(chatId: number, messageId: number): Promise<boolean>;
-  unpinMessage(chatId: number, messageId?: number): Promise<boolean>;
-  setChatDescription(chatId: number, description: string): Promise<boolean>;
-  setMessageReaction(chatId: number, messageId: number, reaction: string): Promise<boolean>;
-  getChatMemberCount(chatId: number): Promise<number>;
-  getChatAdmins(chatId: number): Promise<TelegramChatMember[]>;
-  sendStickerMessage(chatId: number, sticker: string): Promise<{ message_id: number }>;
-  setChatPermissionsAll(
-    chatId: number,
-    permissions: Record<string, boolean | undefined>,
-  ): Promise<boolean>;
-  createInviteLink(chatId: number): Promise<string>;
-  sendPoll(
-    chatId: number,
-    question: string,
-    options: string[],
-    isAnonymous?: boolean,
-    allowsMultipleAnswers?: boolean,
-  ): Promise<{ message_id: number }>;
-}
-
-export interface TelegramAgentDeps {
-  getEndpoint: (endpointKey: string) => TelegramAgentEndpoint;
-}
-
-const endpoints = new Map<string, TelegramAgentEndpoint>();
-let override: TelegramAgentDeps | null = null;
-
-export function registerTelegramAgentEndpoint(
-  endpointKey: string,
-  endpoint: TelegramAgentEndpoint,
-): () => void {
-  endpoints.set(endpointKey, endpoint);
-  return () => {
-    if (endpoints.get(endpointKey) === endpoint) {
-      endpoints.delete(endpointKey);
-    }
-  };
-}
-
-/** Optional override used by tests / transitional callers. Pass `null` to clear. */
-export function setTelegramAgentDeps(deps: TelegramAgentDeps | null): void {
-  override = deps;
-}
-
-export function getTelegramAgentDeps(): TelegramAgentDeps {
-  if (override) return override;
-  return {
-    getEndpoint(endpointKey: string): TelegramAgentEndpoint {
-      const registered = endpoints.get(endpointKey);
-      if (!registered) throw new Error(`Endpoint ${endpointKey} 不存在`);
-      return registered;
-    },
-  };
-}