@zhin.js/adapter-line 5.0.0 → 5.0.1

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # @zhin.js/adapter-line
 
+## 5.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
+
 ## 5.0.0
 
 ### Patch Changes

package/README.md

@@ -19,7 +19,7 @@ pnpm add @zhin.js/adapter-line
 ## Plugin Runtime
 
 - `@zhin.js/adapter` — 约定式 `adapters/line.ts`（`defineAdapter`）
-- `@zhin.js/core` — `messageGatewayToken` 入站/出站
+- `@zhin.js/core` — `Endpoint.emit(...)` 入站、`outboundMessageToken` 出站
 - `@zhin.js/host-http` — `httpHostToken` 注册 Webhook 路由（**非** legacy host-router/Koa）
 - `zhin.js` — `plugin.ts`（`definePlugin`）
 - 配置经插件 `schema.json` 落到 `plugins.<instanceKey>`

package/adapters/line.js

@@ -3,7 +3,6 @@
  * Convention entry: discover `adapters/line.ts` → defineAdapter.
  */
 import { defineAdapter } from 'zhin.js/adapter';
-import { messageGatewayToken, sideEventGatewayToken } from '@zhin.js/core/runtime';
 import { httpHostToken } from '@zhin.js/host-http';
 import { LineEndpoint } from "../lib/endpoint.js";
 import { resolveLineConfig, } from "../lib/protocol.js";
@@ -25,8 +24,6 @@ export default defineAdapter({
         });
         return new LineEndpoint({
             id: context.id,
-            gateway: context.use(messageGatewayToken),
-            sideEvents: context.use(sideEventGatewayToken),
             http: context.use(httpHostToken),
             config,
         });

package/adapters/line.ts

@@ -2,7 +2,6 @@
  * Convention entry: discover `adapters/line.ts` → defineAdapter.
  */
 import { defineAdapter } from 'zhin.js/adapter';
-import { messageGatewayToken, sideEventGatewayToken } from '@zhin.js/core/runtime';
 import { httpHostToken } from '@zhin.js/host-http';
 import { LineEndpoint } from '../src/endpoint.js';
 import {
@@ -30,8 +29,6 @@ export default defineAdapter<LineAdapterConfig>({
     });
     return new LineEndpoint({
       id: context.id,
-      gateway: context.use(messageGatewayToken),
-      sideEvents: context.use(sideEventGatewayToken),
       http: context.use(httpHostToken),
       config,
     });

package/agent/tools/get_group_members.ts

@@ -1,24 +1,16 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
-import { getLineApiConfig } from '../../src/line-agent-deps.js';
 
 export default defineAgentTool<{ groupId: string }>({
   description: 'Get LINE group member IDs',
+  adapter: 'line',
   inputSchema: z.object({
     groupId: z.string().min(1),
   }),
-  async execute({ groupId }) {
+  async execute({ groupId }, context) {
     if (!groupId.startsWith('G')) {
       throw new Error(`Invalid groupId "${groupId}": must start with G`);
     }
-    const { accessToken, apiBaseUrl } = getLineApiConfig();
-    const response = await fetch(`${apiBaseUrl}/v2/bot/group/${groupId}/members/ids`, {
-      headers: { Authorization: `Bearer ${accessToken}` },
-    });
-    if (!response.ok) {
-      const errorText = await response.text();
-      throw new Error(`LINE Group Members API error ${response.status}: ${errorText}`);
-    }
-    return await response.json();
+    return context.$client.getGroupMemberIds(groupId);
   },
 });

package/agent/tools/get_profile.ts

@@ -1,24 +1,16 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
-import { getLineApiConfig } from '../../src/line-agent-deps.js';
 
 export default defineAgentTool<{ userId: string }>({
   description: 'Get LINE user profile by userId',
+  adapter: 'line',
   inputSchema: z.object({
     userId: z.string().min(1),
   }),
-  async execute({ userId }) {
+  async execute({ userId }, context) {
     if (!userId.startsWith('U')) {
       throw new Error(`Invalid userId "${userId}": must start with U`);
     }
-    const { accessToken, apiBaseUrl } = getLineApiConfig();
-    const response = await fetch(`${apiBaseUrl}/v2/profile/${userId}`, {
-      headers: { Authorization: `Bearer ${accessToken}` },
-    });
-    if (!response.ok) {
-      const errorText = await response.text();
-      throw new Error(`LINE Profile API error ${response.status}: ${errorText}`);
-    }
-    return await response.json();
+    return context.$client.getProfile(userId);
   },
 });

package/lib/client.d.ts

@@ -0,0 +1,33 @@
+import type { LineFetch } from './endpoint.js';
+import type { LineEvent, ResolvedLineConfig } from './protocol.js';
+export interface LineGroupMember {
+    readonly user_id: string;
+    readonly nickname: string;
+}
+/** Direct LINE Messaging API client; it has no Endpoint lifecycle methods. */
+export declare class LineClient {
+    readonly config: ResolvedLineConfig;
+    readonly fetch: LineFetch;
+    constructor(config: ResolvedLineConfig, fetch: LineFetch);
+    request<T = unknown>(path: string, init?: {
+        readonly method?: string;
+        readonly body?: string;
+        readonly signal?: AbortSignal;
+    }): Promise<T>;
+    getProfile(userId: string): Promise<unknown>;
+    getGroupMemberIds(groupId: string, start?: string): Promise<{
+        readonly memberIds?: string[];
+        readonly next?: string;
+    }>;
+    getGroupMembers(groupId: string): Promise<LineGroupMember[]>;
+}
+export type LineClientEventMap = Record<string, LineEvent>;
+declare module '@zhin.js/feature-kit' {
+    interface AdapterClientRegistry {
+        readonly line: {
+            readonly client: LineClient;
+            readonly events: LineClientEventMap;
+        };
+    }
+}
+export declare const lineClient: import("@zhin.js/adapter").EndpointClientToken<LineClient, LineClientEventMap>;

package/lib/client.js

@@ -0,0 +1,54 @@
+import { defineEndpointClient } from 'zhin.js/adapter';
+/** Direct LINE Messaging API client; it has no Endpoint lifecycle methods. */
+export class LineClient {
+    config;
+    fetch;
+    constructor(config, fetch) {
+        this.config = config;
+        this.fetch = fetch;
+    }
+    async request(path, init = {}) {
+        const response = await this.fetch(`${this.config.apiBaseUrl}${path}`, {
+            method: init.method ?? 'GET',
+            headers: {
+                Authorization: `Bearer ${this.config.channelAccessToken}`,
+                ...(init.body === undefined ? {} : { 'Content-Type': 'application/json' }),
+            },
+            ...(init.body === undefined ? {} : { body: init.body }),
+            signal: init.signal ?? AbortSignal.timeout(30_000),
+        });
+        if (!response.ok) {
+            const text = await response.text();
+            throw new Error(`LINE API error ${response.status}: ${text}`);
+        }
+        return await response.json();
+    }
+    getProfile(userId) {
+        return this.request(`/v2/profile/${encodeURIComponent(userId)}`);
+    }
+    getGroupMemberIds(groupId, start) {
+        const kind = groupId.startsWith('R') ? 'room' : 'group';
+        const query = start ? `?start=${encodeURIComponent(start)}` : '';
+        return this.request(`/v2/bot/${kind}/${encodeURIComponent(groupId)}/members/ids${query}`);
+    }
+    async getGroupMembers(groupId) {
+        const kind = groupId.startsWith('R') ? 'room' : 'group';
+        const ids = [];
+        let next;
+        do {
+            const page = await this.getGroupMemberIds(groupId, next);
+            ids.push(...(page.memberIds ?? []).filter((id) => typeof id === 'string' && id.length > 0));
+            next = page.next || undefined;
+        } while (next);
+        return Promise.all(ids.map(async (userId) => {
+            try {
+                const profile = await this.request(`/v2/bot/${kind}/${encodeURIComponent(groupId)}/member/${encodeURIComponent(userId)}`);
+                return { user_id: userId, nickname: String(profile.displayName ?? userId) };
+            }
+            catch {
+                return { user_id: userId, nickname: userId };
+            }
+        }));
+    }
+}
+export const lineClient = defineEndpointClient('line');

package/lib/endpoint.d.ts

@@ -1,11 +1,12 @@
+import { Endpoint } from 'zhin.js/adapter';
 /**
  * LineEndpoint — lifecycle, outbound, admit, OpenAPI helpers for agent tools.
  */
-import type { EndpointInstance, EndpointManagement, EndpointSendRequest } from 'zhin.js/adapter';
-import type { MessageGateway, SideEventGateway } from '@zhin.js/core/runtime';
+import { type EndpointManagement, EndpointSendRequest } from 'zhin.js/adapter';
 import type { HttpHost } from '@zhin.js/host-http';
 import type { CapabilityId } from 'zhin.js';
 import { type LineEvent, type ResolvedLineConfig } from './protocol.js';
+import { LineClient } from './client.js';
 export type LineFetch = (url: string, init?: {
     readonly method?: string;
     readonly headers?: Record<string, string>;
@@ -19,23 +20,18 @@ export type LineFetch = (url: string, init?: {
 }>;
 export interface LineEndpointOptions {
     readonly id: CapabilityId;
-    readonly gateway: MessageGateway;
-    readonly sideEvents?: SideEventGateway;
     readonly http: HttpHost;
     readonly config: ResolvedLineConfig;
     readonly fetch?: LineFetch;
 }
-export declare class LineEndpoint implements EndpointInstance {
+export declare class LineEndpoint extends Endpoint<LineClient> {
     #private;
+    readonly client: LineClient;
     readonly management: EndpointManagement;
     constructor(options: LineEndpointOptions);
     /** Used by webhook handler. */
     get isOpen(): boolean;
     get config(): ResolvedLineConfig;
-    getApiConfig(): {
-        accessToken: string;
-        apiBaseUrl: string;
-    };
     start(): Promise<void>;
     open(): void;
     close(): void;
@@ -43,14 +39,4 @@ export declare class LineEndpoint implements EndpointInstance {
     send({ conversation, payload }: EndpointSendRequest): Promise<string>;
     /** Test / internal: admit a parsed event when open (non-webhook path). */
     admit(event: LineEvent): void;
-    /**
-     * group/room 成员列表：Bot API 无群列表，只能按已知 groupId/roomId 拉成员。
-     * members/ids 分页（next continuation token）后逐个取 profile 归一 nickname；
-     * 单个 profile 失败（用户已退群等）时回退 userId 占位，不拖垮整批。
-     */
-    getGroupMembers(groupId: string): Promise<LineGroupMember[]>;
-}
-export interface LineGroupMember {
-    readonly user_id: string;
-    readonly nickname: string;
 }

package/lib/endpoint.js

@@ -1,13 +1,15 @@
+import { Endpoint } from 'zhin.js/adapter';
 import { formatCompact, getAdapterLogger } from '@zhin.js/logger';
-import { registerLineAgentEndpoint } from './line-agent-deps.js';
 import { formatInboundContent, formatOutboundMessages, generateMessageId, isLineLifecycleEvent, isMessageEvent, isValidLineRecipientId, lineInboundConversation, } from './protocol.js';
 import { registerLineWebhookRoutes } from './webhook.js';
 import { receiveLineSideEvent } from './side-event-dispatch.js';
+import { LineClient } from './client.js';
 /** LINE replyToken 有效期短，过期后 reply 必 400；缓存带时间戳，超时弃用改走 push。 */
 const REPLY_TOKEN_TTL_MS = 60_000;
 /** 出站 HTTP 调用统一 30s 超时。 */
 const OUTBOUND_TIMEOUT_MS = 30_000;
-export class LineEndpoint {
+export class LineEndpoint extends Endpoint {
+    client;
     #logger;
     #options;
     #fetch;
@@ -15,12 +17,13 @@ export class LineEndpoint {
     #replyTokenCache = new Map();
     #open = false;
     #started = false;
-    #unregisterAgent;
     management = createLineEndpointManagement(this);
     constructor(options) {
+        super();
         this.#logger = getAdapterLogger('line', options.config.id);
         this.#options = options;
         this.#fetch = options.fetch ?? globalThis.fetch;
+        this.client = new LineClient(options.config, this.#fetch);
     }
     /** Used by webhook handler. */
     get isOpen() {
@@ -29,18 +32,11 @@ export class LineEndpoint {
     get config() {
         return this.#options.config;
     }
-    getApiConfig() {
-        return {
-            accessToken: this.#options.config.channelAccessToken,
-            apiBaseUrl: this.#options.config.apiBaseUrl,
-        };
-    }
     async start() {
         if (this.#started)
             return;
         this.#started = true;
         try {
-            this.#unregisterAgent = registerLineAgentEndpoint(this.#options.config.id, this);
             this.#routeReleases.push(...registerLineWebhookRoutes(this.#options.http, this));
             this.#logger.debug(formatCompact({
                 endpoint: this.#options.config.id,
@@ -65,8 +61,6 @@ export class LineEndpoint {
         this.#replyTokenCache.clear();
         for (const release of this.#routeReleases.splice(0))
             release();
-        this.#unregisterAgent?.();
-        this.#unregisterAgent = undefined;
         this.#started = false;
         this.#logger.debug(formatCompact({ op: 'disconnect' }));
     }
@@ -105,15 +99,22 @@ export class LineEndpoint {
     admit(event) {
         if (!this.#open)
             return;
+        void this.emitPlatform(event.type || 'event', event).catch((error) => {
+            this.#logger.warn(formatCompact({
+                op: 'line_platform_event_failed',
+                event: event.type,
+                error: error instanceof Error ? error.message : String(error),
+            }));
+        });
         if (isLineLifecycleEvent(event)) {
-            receiveLineSideEvent(this.#options.sideEvents, String(this.#options.id), this.#options.config.id, event, this.#logger);
+            receiveLineSideEvent((name, payload) => this.emit(name, payload), String(this.#options.id), this.#options.config.id, event, this.#logger);
             return;
         }
         const conversation = lineInboundConversation(String(this.#options.id), event.source);
         if ('replyToken' in event && typeof event.replyToken === 'string') {
             this.#replyTokenCache.set(conversation.id, { token: event.replyToken, timestamp: Date.now() });
         }
-        void this.#options.gateway.receive({
+        void this.emit('message.receive', {
             conversation,
             message: { conversation, id: generateMessageId(event) },
             content: formatInboundContent(event),
@@ -171,50 +172,10 @@ export class LineEndpoint {
         const result = await response.json();
         return result.sentMessages?.[0]?.id || `push-${Date.now()}`;
     }
-    /**
-     * group/room 成员列表：Bot API 无群列表，只能按已知 groupId/roomId 拉成员。
-     * members/ids 分页（next continuation token）后逐个取 profile 归一 nickname；
-     * 单个 profile 失败（用户已退群等）时回退 userId 占位，不拖垮整批。
-     */
-    async getGroupMembers(groupId) {
-        const kind = groupId.startsWith('R') ? 'room' : 'group';
-        const memberIds = [];
-        let start;
-        do {
-            const query = start ? `?start=${encodeURIComponent(start)}` : '';
-            const data = await this.#get(`${this.#options.config.apiBaseUrl}/v2/bot/${kind}/${encodeURIComponent(groupId)}/members/ids${query}`);
-            for (const id of data.memberIds ?? []) {
-                if (typeof id === 'string' && id)
-                    memberIds.push(id);
-            }
-            start = data.next || undefined;
-        } while (start);
-        return Promise.all(memberIds.map(async (userId) => {
-            try {
-                const profile = await this.#get(`${this.#options.config.apiBaseUrl}/v2/bot/${kind}/${encodeURIComponent(groupId)}/member/${encodeURIComponent(userId)}`);
-                return { user_id: userId, nickname: String(profile.displayName ?? userId) };
-            }
-            catch {
-                return { user_id: userId, nickname: userId };
-            }
-        }));
-    }
-    async #get(url) {
-        const response = await this.#fetch(url, {
-            method: 'GET',
-            headers: { Authorization: `Bearer ${this.#options.config.channelAccessToken}` },
-            signal: AbortSignal.timeout(OUTBOUND_TIMEOUT_MS),
-        });
-        if (!response.ok) {
-            const errorText = await response.text();
-            throw new Error(`LINE API error ${response.status}: ${errorText}`);
-        }
-        return response.json();
-    }
 }
 function createLineEndpointManagement(endpoint) {
     return Object.freeze({
         // listGroups 不接：LINE Bot API 没有"我加入了哪些群"的接口，群 id 只能来自入站事件。
-        listGroupMembers: (groupId) => endpoint.getGroupMembers(groupId),
+        listGroupMembers: (groupId) => endpoint.client.getGroupMembers(groupId),
     });
 }

package/lib/index.d.ts

@@ -1,4 +1,4 @@
 export { formatInboundContent, formatOutboundMessages, generateMessageId, isMessageEvent, isPostbackEvent, isValidLineRecipientId, normalizeWebhookPath, readTextBody, resolveChannel, resolveLineConfig, verifySignature, type LineAdapterConfig, type LineApiResponse, type LineChannel, type LineEvent, type LineFollowEvent, type LineJoinEvent, type LineLeaveEvent, type LineMessage, type LineMessageEvent, type LinePostbackEvent, type LinePushRequest, type LineReplyMessage, type LineReplyRequest, type LineSource, type LineUnfollowEvent, type LineUser, type LineWebhookBody, type LineWireSegment, type ResolvedLineConfig, } from './protocol.js';
 export { LineEndpoint, type LineEndpointOptions, type LineFetch, } from './endpoint.js';
 export { registerLineWebhookRoutes, handleLineWebhookRequest, type LineWebhookHandler, } from './webhook.js';
-export { getLineAgentDeps, getLineApiConfig, registerLineAgentEndpoint, setLineAgentDeps, type LineAgentDeps, type LineAgentEndpoint, } from './line-agent-deps.js';
+export { LineClient, lineClient, type LineClientEventMap, type LineGroupMember, } from './client.js';

package/lib/index.js

@@ -1,4 +1,4 @@
 export { formatInboundContent, formatOutboundMessages, generateMessageId, isMessageEvent, isPostbackEvent, isValidLineRecipientId, normalizeWebhookPath, readTextBody, resolveChannel, resolveLineConfig, verifySignature, } from './protocol.js';
 export { LineEndpoint, } from './endpoint.js';
 export { registerLineWebhookRoutes, handleLineWebhookRequest, } from './webhook.js';
-export { getLineAgentDeps, getLineApiConfig, registerLineAgentEndpoint, setLineAgentDeps, } from './line-agent-deps.js';
+export { LineClient, lineClient, } from './client.js';

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

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

package/lib/protocol.d.ts

@@ -144,7 +144,7 @@ export declare function resolveChannel(source: LineSource): LineChannel;
  */
 export declare function lineInboundConversation(endpointKey: string, source: LineSource): ConversationRef;
 export declare function generateMessageId(event: LineEvent): string;
-/** Build inbound text for MessageGateway.receive. */
+/** Build inbound text for OutboundMessageService.receive. */
 export declare function formatInboundContent(event: LineEvent): string;
 export declare function verifySignature(channelSecret: string, body: string, signature: string): boolean;
 export declare function isValidLineRecipientId(id: string): boolean;

package/lib/protocol.js

@@ -77,7 +77,7 @@ export function generateMessageId(event) {
         return event.message.id;
     return `${event.type}-${event.timestamp}`;
 }
-/** Build inbound text for MessageGateway.receive. */
+/** Build inbound text for OutboundMessageService.receive. */
 export function formatInboundContent(event) {
     if (isMessageEvent(event)) {
         const msg = event.message;

package/lib/side-event-dispatch.d.ts

@@ -1,4 +1,4 @@
-import type { SideEventGateway } from '@zhin.js/core/runtime';
+import type { EndpointEventEmitter } from 'zhin.js/adapter';
 import { type getAdapterLogger } from '@zhin.js/logger';
 import { type LineEvent } from './protocol.js';
-export declare function receiveLineSideEvent(sideEvents: SideEventGateway | undefined, endpointKey: string, configId: string, event: LineEvent, logger: ReturnType<typeof getAdapterLogger>): void;
+export declare function receiveLineSideEvent(emit: EndpointEventEmitter, endpointKey: string, configId: string, event: LineEvent, logger: ReturnType<typeof getAdapterLogger>): void;

package/lib/side-event-dispatch.js

@@ -15,13 +15,13 @@ function mapLineLifecycleParts(type) {
             return { scene_type: 'line', sub_type: type };
     }
 }
-export function receiveLineSideEvent(sideEvents, endpointKey, configId, event, logger) {
-    if (!sideEvents || !isLineLifecycleEvent(event))
+export function receiveLineSideEvent(emit, endpointKey, configId, event, logger) {
+    if (!isLineLifecycleEvent(event))
         return;
     const parts = mapLineLifecycleParts(event.type);
     const conversation = lineInboundConversation(endpointKey, event.source);
     const userId = event.source.userId || conversation.id;
-    void sideEvents.receiveNotice(buildNotice(event, {
+    void emit('notice.receive', buildNotice(event, {
         $id: `line:${event.type}:${event.timestamp}:${userId}`,
         $adapter: 'line',
         $endpoint: configId,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-line",
-  "version": "5.0.0",
+  "version": "5.0.1",
   "description": "Zhin.js LINE Messaging API adapter for Plugin Runtime (HTTP webhook)",
   "type": "module",
   "main": "./lib/index.js",
@@ -32,20 +32,21 @@
     "directory": "plugins/adapters/line"
   },
   "dependencies": {
-    "@zhin.js/adapter": "1.2.0",
-    "@zhin.js/core": "1.5.13",
-    "@zhin.js/host-http": "1.0.12",
+    "@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.2.0",
-    "@zhin.js/agent": "1.1.15",
-    "@zhin.js/command": "1.0.15",
-    "@zhin.js/core": "1.5.13",
-    "@zhin.js/host-http": "1.0.12",
-    "zhin.js": "6.0.13"
+    "@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/host-http": "1.0.13",
+    "zhin.js": "6.0.14"
   },
   "peerDependenciesMeta": {
     "@zhin.js/agent": {
@@ -66,8 +67,8 @@
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
     "zod": "^4.4.3",
-    "@zhin.js/agent": "1.1.15",
-    "zhin.js": "6.0.13"
+    "@zhin.js/agent": "1.1.16",
+    "zhin.js": "6.0.14"
   },
   "files": [
     "adapters",

package/src/client.ts

@@ -0,0 +1,87 @@
+import type { LineFetch } from './endpoint.js';
+import { defineEndpointClient } from 'zhin.js/adapter';
+import type { LineEvent, ResolvedLineConfig } from './protocol.js';
+
+export interface LineGroupMember {
+  readonly user_id: string;
+  readonly nickname: string;
+}
+
+/** Direct LINE Messaging API client; it has no Endpoint lifecycle methods. */
+export class LineClient {
+  constructor(
+    readonly config: ResolvedLineConfig,
+    readonly fetch: LineFetch,
+  ) {}
+
+  async request<T = unknown>(path: string, init: {
+    readonly method?: string;
+    readonly body?: string;
+    readonly signal?: AbortSignal;
+  } = {}): Promise<T> {
+    const response = await this.fetch(`${this.config.apiBaseUrl}${path}`, {
+      method: init.method ?? 'GET',
+      headers: {
+        Authorization: `Bearer ${this.config.channelAccessToken}`,
+        ...(init.body === undefined ? {} : { 'Content-Type': 'application/json' }),
+      },
+      ...(init.body === undefined ? {} : { body: init.body }),
+      signal: init.signal ?? AbortSignal.timeout(30_000),
+    });
+    if (!response.ok) {
+      const text = await response.text();
+      throw new Error(`LINE API error ${response.status}: ${text}`);
+    }
+    return await response.json() as T;
+  }
+
+  getProfile(userId: string): Promise<unknown> {
+    return this.request(`/v2/profile/${encodeURIComponent(userId)}`);
+  }
+
+  getGroupMemberIds(groupId: string, start?: string): Promise<{
+    readonly memberIds?: string[];
+    readonly next?: string;
+  }> {
+    const kind = groupId.startsWith('R') ? 'room' : 'group';
+    const query = start ? `?start=${encodeURIComponent(start)}` : '';
+    return this.request(
+      `/v2/bot/${kind}/${encodeURIComponent(groupId)}/members/ids${query}`,
+    );
+  }
+
+  async getGroupMembers(groupId: string): Promise<LineGroupMember[]> {
+    const kind = groupId.startsWith('R') ? 'room' : 'group';
+    const ids: string[] = [];
+    let next: string | undefined;
+    do {
+      const page = await this.getGroupMemberIds(groupId, next);
+      ids.push(...(page.memberIds ?? []).filter((id) => typeof id === 'string' && id.length > 0));
+      next = page.next || undefined;
+    } while (next);
+
+    return Promise.all(ids.map(async (userId) => {
+      try {
+        const profile = await this.request<{ displayName?: string }>(
+          `/v2/bot/${kind}/${encodeURIComponent(groupId)}/member/${encodeURIComponent(userId)}`,
+        );
+        return { user_id: userId, nickname: String(profile.displayName ?? userId) };
+      } catch {
+        return { user_id: userId, nickname: userId };
+      }
+    }));
+  }
+}
+
+export type LineClientEventMap = Record<string, LineEvent>;
+
+declare module '@zhin.js/feature-kit' {
+  interface AdapterClientRegistry {
+    readonly line: {
+      readonly client: LineClient;
+      readonly events: LineClientEventMap;
+    };
+  }
+}
+
+export const lineClient = defineEndpointClient<LineClient, LineClientEventMap>('line');

package/src/endpoint.ts

@@ -1,12 +1,11 @@
+import { Endpoint } from 'zhin.js/adapter';
 /**
  * LineEndpoint — lifecycle, outbound, admit, OpenAPI helpers for agent tools.
  */
-import type { EndpointInstance, EndpointManagement, EndpointSendRequest } from 'zhin.js/adapter';
-import type { MessageGateway, SideEventGateway } from '@zhin.js/core/runtime';
+import { type EndpointManagement, EndpointSendRequest } from 'zhin.js/adapter';
 import type { HttpHost, HttpRouteRegistration } from '@zhin.js/host-http';
 import { formatCompact, getAdapterLogger } from '@zhin.js/logger';
 import type { CapabilityId } from 'zhin.js';
-import { registerLineAgentEndpoint } from './line-agent-deps.js';
 import {
   formatInboundContent,
   formatOutboundMessages,
@@ -21,6 +20,7 @@ import {
 } from './protocol.js';
 import { registerLineWebhookRoutes } from './webhook.js';
 import { receiveLineSideEvent } from './side-event-dispatch.js';
+import { LineClient } from './client.js';
 
 /** LINE replyToken 有效期短，过期后 reply 必 400；缓存带时间戳，超时弃用改走 push。 */
 const REPLY_TOKEN_TTL_MS = 60_000;
@@ -44,14 +44,13 @@ export type LineFetch = (
 
 export interface LineEndpointOptions {
   readonly id: CapabilityId;
-  readonly gateway: MessageGateway;
-  readonly sideEvents?: SideEventGateway;
   readonly http: HttpHost;
   readonly config: ResolvedLineConfig;
   readonly fetch?: LineFetch;
 }
 
-export class LineEndpoint implements EndpointInstance {
+export class LineEndpoint extends Endpoint<LineClient> {
+  readonly client: LineClient;
   readonly #logger!: ReturnType<typeof getAdapterLogger>;
 
   readonly #options: LineEndpointOptions;
@@ -60,13 +59,14 @@ export class LineEndpoint implements EndpointInstance {
   #replyTokenCache = new Map<string, { token: string; timestamp: number }>();
   #open = false;
   #started = false;
-  #unregisterAgent?: () => void;
   readonly management: EndpointManagement = createLineEndpointManagement(this);
 
   constructor(options: LineEndpointOptions) {
+    super();
     this.#logger = getAdapterLogger('line', options.config.id);
     this.#options = options;
     this.#fetch = options.fetch ?? globalThis.fetch;
+    this.client = new LineClient(options.config, this.#fetch);
   }
 
   /** Used by webhook handler. */
@@ -78,18 +78,10 @@ export class LineEndpoint implements EndpointInstance {
     return this.#options.config;
   }
 
-  getApiConfig(): { accessToken: string; apiBaseUrl: string } {
-    return {
-      accessToken: this.#options.config.channelAccessToken,
-      apiBaseUrl: this.#options.config.apiBaseUrl,
-    };
-  }
-
   async start(): Promise<void> {
     if (this.#started) return;
     this.#started = true;
     try {
-      this.#unregisterAgent = registerLineAgentEndpoint(this.#options.config.id, this);
       this.#routeReleases.push(...registerLineWebhookRoutes(this.#options.http, this));
       this.#logger.debug(formatCompact({
         endpoint: this.#options.config.id,
@@ -115,8 +107,6 @@ export class LineEndpoint implements EndpointInstance {
     this.#open = false;
     this.#replyTokenCache.clear();
     for (const release of this.#routeReleases.splice(0)) release();
-    this.#unregisterAgent?.();
-    this.#unregisterAgent = undefined;
     this.#started = false;
     this.#logger.debug(formatCompact({ op: 'disconnect' }));
   }
@@ -158,9 +148,16 @@ export class LineEndpoint implements EndpointInstance {
   /** Test / internal: admit a parsed event when open (non-webhook path). */
   admit(event: LineEvent): void {
     if (!this.#open) return;
+    void this.emitPlatform(event.type || 'event', event).catch((error) => {
+      this.#logger.warn(formatCompact({
+        op: 'line_platform_event_failed',
+        event: event.type,
+        error: error instanceof Error ? error.message : String(error),
+      }));
+    });
     if (isLineLifecycleEvent(event)) {
       receiveLineSideEvent(
-        this.#options.sideEvents,
+        (name, payload) => this.emit(name, payload),
         String(this.#options.id),
         this.#options.config.id,
         event,
@@ -172,7 +169,7 @@ export class LineEndpoint implements EndpointInstance {
     if ('replyToken' in event && typeof event.replyToken === 'string') {
       this.#replyTokenCache.set(conversation.id, { token: event.replyToken, timestamp: Date.now() });
     }
-    void this.#options.gateway.receive({
+    void this.emit('message.receive', {
       conversation,
       message: { conversation, id: generateMessageId(event) },
       content: formatInboundContent(event),
@@ -244,55 +241,11 @@ export class LineEndpoint implements EndpointInstance {
    * members/ids 分页（next continuation token）后逐个取 profile 归一 nickname；
    * 单个 profile 失败（用户已退群等）时回退 userId 占位，不拖垮整批。
    */
-  async getGroupMembers(groupId: string): Promise<LineGroupMember[]> {
-    const kind = groupId.startsWith('R') ? 'room' : 'group';
-    const memberIds: string[] = [];
-    let start: string | undefined;
-    do {
-      const query = start ? `?start=${encodeURIComponent(start)}` : '';
-      const data = await this.#get(
-        `${this.#options.config.apiBaseUrl}/v2/bot/${kind}/${encodeURIComponent(groupId)}/members/ids${query}`,
-      ) as { memberIds?: string[]; next?: string };
-      for (const id of data.memberIds ?? []) {
-        if (typeof id === 'string' && id) memberIds.push(id);
-      }
-      start = data.next || undefined;
-    } while (start);
-
-    return Promise.all(memberIds.map(async (userId) => {
-      try {
-        const profile = await this.#get(
-          `${this.#options.config.apiBaseUrl}/v2/bot/${kind}/${encodeURIComponent(groupId)}/member/${encodeURIComponent(userId)}`,
-        ) as { displayName?: string };
-        return { user_id: userId, nickname: String(profile.displayName ?? userId) };
-      } catch {
-        return { user_id: userId, nickname: userId };
-      }
-    }));
-  }
-
-  async #get(url: string): Promise<unknown> {
-    const response = await this.#fetch(url, {
-      method: 'GET',
-      headers: { Authorization: `Bearer ${this.#options.config.channelAccessToken}` },
-      signal: AbortSignal.timeout(OUTBOUND_TIMEOUT_MS),
-    });
-    if (!response.ok) {
-      const errorText = await response.text();
-      throw new Error(`LINE API error ${response.status}: ${errorText}`);
-    }
-    return response.json();
-  }
-}
-
-export interface LineGroupMember {
-  readonly user_id: string;
-  readonly nickname: string;
 }
 
 function createLineEndpointManagement(endpoint: LineEndpoint): EndpointManagement {
   return Object.freeze<EndpointManagement>({
     // listGroups 不接：LINE Bot API 没有"我加入了哪些群"的接口，群 id 只能来自入站事件。
-    listGroupMembers: (groupId) => endpoint.getGroupMembers(groupId),
+    listGroupMembers: (groupId) => endpoint.client.getGroupMembers(groupId),
   });
 }

package/src/index.ts

@@ -44,10 +44,8 @@ export {
 } from './webhook.js';
 
 export {
-  getLineAgentDeps,
-  getLineApiConfig,
-  registerLineAgentEndpoint,
-  setLineAgentDeps,
-  type LineAgentDeps,
-  type LineAgentEndpoint,
-} from './line-agent-deps.js';
+  LineClient,
+  lineClient,
+  type LineClientEventMap,
+  type LineGroupMember,
+} from './client.js';

package/src/protocol.ts

@@ -243,7 +243,7 @@ export function generateMessageId(event: LineEvent): string {
   return `${event.type}-${event.timestamp}`;
 }
 
-/** Build inbound text for MessageGateway.receive. */
+/** Build inbound text for OutboundMessageService.receive. */
 export function formatInboundContent(event: LineEvent): string {
   if (isMessageEvent(event)) {
     const msg = event.message;

package/src/side-event-dispatch.ts

@@ -1,5 +1,5 @@
 import { buildNotice, senderFromId } from '@zhin.js/core';
-import type { SideEventGateway } from '@zhin.js/core/runtime';
+import type { EndpointEventEmitter } from 'zhin.js/adapter';
 import { formatCompact, type getAdapterLogger } from '@zhin.js/logger';
 import {
   isLineLifecycleEvent,
@@ -23,17 +23,17 @@ function mapLineLifecycleParts(type: LineEvent['type']): { scene_type: string; s
 }
 
 export function receiveLineSideEvent(
-  sideEvents: SideEventGateway | undefined,
+  emit: EndpointEventEmitter,
   endpointKey: string,
   configId: string,
   event: LineEvent,
   logger: ReturnType<typeof getAdapterLogger>,
 ): void {
-  if (!sideEvents || !isLineLifecycleEvent(event)) return;
+  if (!isLineLifecycleEvent(event)) return;
   const parts = mapLineLifecycleParts(event.type);
   const conversation = lineInboundConversation(endpointKey, event.source);
   const userId = event.source.userId || conversation.id;
-  void sideEvents.receiveNotice(buildNotice(event, {
+  void emit('notice.receive', buildNotice(event, {
     $id: `line:${event.type}:${event.timestamp}:${userId}`,
     $adapter: 'line' as never,
     $endpoint: configId,

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

@@ -1,24 +0,0 @@
-/**
- * Agent tool deps for line (get_profile / get_group_members).
- * Endpoints register themselves on start; tools look up the active API config.
- */
-export interface LineAgentEndpoint {
-    getApiConfig(): {
-        accessToken: string;
-        apiBaseUrl: string;
-    };
-}
-export interface LineAgentDeps {
-    getApiConfig: () => {
-        accessToken: string;
-        apiBaseUrl: string;
-    };
-}
-export declare function registerLineAgentEndpoint(endpointKey: string, endpoint: LineAgentEndpoint): () => void;
-/** Optional override used by tests / transitional callers. Pass `null` to clear. */
-export declare function setLineAgentDeps(deps: LineAgentDeps | null): void;
-export declare function getLineAgentDeps(): LineAgentDeps;
-export declare function getLineApiConfig(): {
-    accessToken: string;
-    apiBaseUrl: string;
-};

package/lib/line-agent-deps.js

@@ -1,33 +0,0 @@
-/**
- * Agent tool deps for line (get_profile / get_group_members).
- * Endpoints register themselves on start; tools look up the active API config.
- */
-const endpoints = new Map();
-let override = null;
-export function registerLineAgentEndpoint(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 setLineAgentDeps(deps) {
-    override = deps;
-}
-export function getLineAgentDeps() {
-    if (override)
-        return override;
-    return {
-        getApiConfig() {
-            const first = endpoints.values().next().value;
-            if (!first)
-                throw new Error('LINE channel access token not configured');
-            return first.getApiConfig();
-        },
-    };
-}
-export function getLineApiConfig() {
-    return getLineAgentDeps().getApiConfig();
-}

package/src/line-agent-deps.ts

@@ -1,47 +0,0 @@
-/**
- * Agent tool deps for line (get_profile / get_group_members).
- * Endpoints register themselves on start; tools look up the active API config.
- */
-
-export interface LineAgentEndpoint {
-  getApiConfig(): { accessToken: string; apiBaseUrl: string };
-}
-
-export interface LineAgentDeps {
-  getApiConfig: () => { accessToken: string; apiBaseUrl: string };
-}
-
-const endpoints = new Map<string, LineAgentEndpoint>();
-let override: LineAgentDeps | null = null;
-
-export function registerLineAgentEndpoint(
-  endpointKey: string,
-  endpoint: LineAgentEndpoint,
-): () => 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 setLineAgentDeps(deps: LineAgentDeps | null): void {
-  override = deps;
-}
-
-export function getLineAgentDeps(): LineAgentDeps {
-  if (override) return override;
-  return {
-    getApiConfig() {
-      const first = endpoints.values().next().value as LineAgentEndpoint | undefined;
-      if (!first) throw new Error('LINE channel access token not configured');
-      return first.getApiConfig();
-    },
-  };
-}
-
-export function getLineApiConfig(): { accessToken: string; apiBaseUrl: string } {
-  return getLineAgentDeps().getApiConfig();
-}