@zhin.js/adapter-line 4.0.13 → 4.0.14

package/CHANGELOG.md

@@ -1,5 +1,37 @@
 # @zhin.js/adapter-line
 
+## 4.0.14
+
+### Patch Changes
+
+- 5969c5b: Add SideEventGateway so adapters forward notice/request/system into HandlerIndex. HandlerContext now exposes only generation-safe capabilities and prompt ports; live Endpoint escape hatches are removed.
+- Updated dependencies [5969c5b]
+- Updated dependencies [d336a3f]
+- Updated dependencies [0c82a7e]
+- Updated dependencies [b9217e4]
+- Updated dependencies [5969c5b]
+- Updated dependencies [5969c5b]
+- Updated dependencies [974772e]
+- Updated dependencies [5969c5b]
+- Updated dependencies [5969c5b]
+- Updated dependencies [2f786bd]
+- Updated dependencies [63d89f9]
+- Updated dependencies [71c7cdd]
+- Updated dependencies [3cca0ea]
+- Updated dependencies [1312ca0]
+- Updated dependencies [985fa22]
+- Updated dependencies [04b861d]
+- Updated dependencies [a23d544]
+- Updated dependencies [8cddabf]
+- Updated dependencies [dbe5081]
+  - @zhin.js/im-contract@1.0.4
+  - @zhin.js/core@1.5.12
+  - @zhin.js/adapter@1.1.11
+  - @zhin.js/agent@1.1.14
+  - @zhin.js/host-http@1.0.11
+  - @zhin.js/command@1.0.15
+  - zhin.js@6.0.12
+
 ## 4.0.13
 
 ### Patch Changes

package/adapters/line.js

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

package/lib/endpoint.d.ts

@@ -2,7 +2,7 @@
  * LineEndpoint — lifecycle, outbound, admit, OpenAPI helpers for agent tools.
  */
 import type { EndpointInstance, EndpointManagement, EndpointSendRequest } from 'zhin.js/adapter';
-import type { MessageGateway } from '@zhin.js/core/runtime';
+import type { MessageGateway, SideEventGateway } from '@zhin.js/core/runtime';
 import type { HttpHost } from '@zhin.js/host-http';
 import type { CapabilityId } from 'zhin.js';
 import { type LineEvent, type ResolvedLineConfig } from './protocol.js';
@@ -20,6 +20,7 @@ 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;

package/lib/endpoint.js

@@ -1,7 +1,8 @@
 import { formatCompact, getAdapterLogger } from '@zhin.js/logger';
 import { registerLineAgentEndpoint } from './line-agent-deps.js';
-import { formatInboundContent, formatOutboundMessages, generateMessageId, isMessageEvent, isValidLineRecipientId, lineInboundConversation, } from './protocol.js';
+import { formatInboundContent, formatOutboundMessages, generateMessageId, isLineLifecycleEvent, isMessageEvent, isValidLineRecipientId, lineInboundConversation, } from './protocol.js';
 import { registerLineWebhookRoutes } from './webhook.js';
+import { receiveLineSideEvent } from './side-event-dispatch.js';
 /** LINE replyToken 有效期短，过期后 reply 必 400；缓存带时间戳，超时弃用改走 push。 */
 const REPLY_TOKEN_TTL_MS = 60_000;
 /** 出站 HTTP 调用统一 30s 超时。 */
@@ -104,6 +105,10 @@ export class LineEndpoint {
     admit(event) {
         if (!this.#open)
             return;
+        if (isLineLifecycleEvent(event)) {
+            receiveLineSideEvent(this.#options.sideEvents, 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() });

package/lib/protocol.d.ts

@@ -135,6 +135,7 @@ export interface LineChannel {
 export declare function resolveLineConfig(config?: LineAdapterConfig): ResolvedLineConfig;
 export declare function normalizeWebhookPath(path: string): string;
 export declare function isMessageEvent(event: LineEvent): event is LineMessageEvent;
+export declare function isLineLifecycleEvent(event: LineEvent): boolean;
 export declare function isPostbackEvent(event: LineEvent): event is LinePostbackEvent;
 export declare function resolveChannel(source: LineSource): LineChannel;
 /**

package/lib/protocol.js

@@ -39,6 +39,12 @@ export function normalizeWebhookPath(path) {
 export function isMessageEvent(event) {
     return event.type === 'message' && 'message' in event && event.message != null;
 }
+export function isLineLifecycleEvent(event) {
+    return event.type === 'follow'
+        || event.type === 'unfollow'
+        || event.type === 'join'
+        || event.type === 'leave';
+}
 export function isPostbackEvent(event) {
     return event.type === 'postback' && 'postback' in event;
 }

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

@@ -0,0 +1,4 @@
+import type { SideEventGateway } from '@zhin.js/core/runtime';
+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;

package/lib/side-event-dispatch.js

@@ -0,0 +1,42 @@
+import { buildNotice, senderFromId } from '@zhin.js/core';
+import { formatCompact } from '@zhin.js/logger';
+import { isLineLifecycleEvent, lineInboundConversation, } from './protocol.js';
+function mapLineLifecycleParts(type) {
+    switch (type) {
+        case 'follow':
+            return { scene_type: 'friend', sub_type: 'increase' };
+        case 'unfollow':
+            return { scene_type: 'friend', sub_type: 'decrease' };
+        case 'join':
+            return { scene_type: 'group', sub_type: 'member_increase' };
+        case 'leave':
+            return { scene_type: 'group', sub_type: 'member_decrease' };
+        default:
+            return { scene_type: 'line', sub_type: type };
+    }
+}
+export function receiveLineSideEvent(sideEvents, endpointKey, configId, event, logger) {
+    if (!sideEvents || !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, {
+        $id: `line:${event.type}:${event.timestamp}:${userId}`,
+        $adapter: 'line',
+        $endpoint: configId,
+        $type: 'notice',
+        $scene_id: conversation.id,
+        $scene_type: parts.scene_type,
+        $sub_type: parts.sub_type,
+        $actor: senderFromId(userId),
+        $timestamp: event.timestamp,
+    })).catch((err) => {
+        logger.warn(formatCompact({
+            op: 'line_side_event_failed',
+            endpoint: configId,
+            event: event.type,
+            error: err instanceof Error ? err.message : String(err),
+        }));
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-line",
-  "version": "4.0.13",
+  "version": "4.0.14",
   "description": "Zhin.js LINE Messaging API adapter for Plugin Runtime (HTTP webhook)",
   "type": "module",
   "main": "./lib/index.js",
@@ -32,20 +32,20 @@
     "directory": "plugins/adapters/line"
   },
   "dependencies": {
-    "@zhin.js/adapter": "1.1.10",
-    "@zhin.js/core": "1.5.11",
-    "@zhin.js/host-http": "1.0.10",
-    "@zhin.js/im-contract": "1.0.3",
+    "@zhin.js/adapter": "1.1.11",
+    "@zhin.js/core": "1.5.12",
+    "@zhin.js/host-http": "1.0.11",
+    "@zhin.js/im-contract": "1.0.4",
     "@zhin.js/logger": "1.0.76"
   },
   "peerDependencies": {
     "zod": "^4.0.0",
-    "@zhin.js/adapter": "1.1.10",
-    "@zhin.js/agent": "1.1.13",
-    "@zhin.js/command": "1.0.14",
-    "@zhin.js/core": "1.5.11",
-    "@zhin.js/host-http": "1.0.10",
-    "zhin.js": "6.0.11"
+    "@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/host-http": "1.0.11",
+    "zhin.js": "6.0.12"
   },
   "peerDependenciesMeta": {
     "@zhin.js/agent": {
@@ -66,8 +66,8 @@
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
     "zod": "^4.4.3",
-    "@zhin.js/agent": "1.1.13",
-    "zhin.js": "6.0.11"
+    "@zhin.js/agent": "1.1.14",
+    "zhin.js": "6.0.12"
   },
   "files": [
     "adapters",

package/src/endpoint.ts

@@ -2,7 +2,7 @@
  * LineEndpoint — lifecycle, outbound, admit, OpenAPI helpers for agent tools.
  */
 import type { EndpointInstance, EndpointManagement, EndpointSendRequest } from 'zhin.js/adapter';
-import type { MessageGateway } from '@zhin.js/core/runtime';
+import type { MessageGateway, SideEventGateway } from '@zhin.js/core/runtime';
 import type { HttpHost, HttpRouteRegistration } from '@zhin.js/host-http';
 import { formatCompact, getAdapterLogger } from '@zhin.js/logger';
 import type { CapabilityId } from 'zhin.js';
@@ -11,6 +11,7 @@ import {
   formatInboundContent,
   formatOutboundMessages,
   generateMessageId,
+  isLineLifecycleEvent,
   isMessageEvent,
   isValidLineRecipientId,
   lineInboundConversation,
@@ -19,6 +20,7 @@ import {
   type ResolvedLineConfig,
 } from './protocol.js';
 import { registerLineWebhookRoutes } from './webhook.js';
+import { receiveLineSideEvent } from './side-event-dispatch.js';
 
 /** LINE replyToken 有效期短，过期后 reply 必 400；缓存带时间戳，超时弃用改走 push。 */
 const REPLY_TOKEN_TTL_MS = 60_000;
@@ -43,6 +45,7 @@ export type LineFetch = (
 export interface LineEndpointOptions {
   readonly id: CapabilityId;
   readonly gateway: MessageGateway;
+  readonly sideEvents?: SideEventGateway;
   readonly http: HttpHost;
   readonly config: ResolvedLineConfig;
   readonly fetch?: LineFetch;
@@ -155,6 +158,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;
+    if (isLineLifecycleEvent(event)) {
+      receiveLineSideEvent(
+        this.#options.sideEvents,
+        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() });

package/src/protocol.ts

@@ -201,6 +201,13 @@ export function isMessageEvent(event: LineEvent): event is LineMessageEvent {
   return event.type === 'message' && 'message' in event && (event as LineMessageEvent).message != null;
 }
 
+export function isLineLifecycleEvent(event: LineEvent): boolean {
+  return event.type === 'follow'
+    || event.type === 'unfollow'
+    || event.type === 'join'
+    || event.type === 'leave';
+}
+
 export function isPostbackEvent(event: LineEvent): event is LinePostbackEvent {
   return event.type === 'postback' && 'postback' in event;
 }

package/src/side-event-dispatch.ts

@@ -0,0 +1,54 @@
+import { buildNotice, senderFromId } from '@zhin.js/core';
+import type { SideEventGateway } from '@zhin.js/core/runtime';
+import { formatCompact, type getAdapterLogger } from '@zhin.js/logger';
+import {
+  isLineLifecycleEvent,
+  lineInboundConversation,
+  type LineEvent,
+} from './protocol.js';
+
+function mapLineLifecycleParts(type: LineEvent['type']): { scene_type: string; sub_type: string } {
+  switch (type) {
+    case 'follow':
+      return { scene_type: 'friend', sub_type: 'increase' };
+    case 'unfollow':
+      return { scene_type: 'friend', sub_type: 'decrease' };
+    case 'join':
+      return { scene_type: 'group', sub_type: 'member_increase' };
+    case 'leave':
+      return { scene_type: 'group', sub_type: 'member_decrease' };
+    default:
+      return { scene_type: 'line', sub_type: type };
+  }
+}
+
+export function receiveLineSideEvent(
+  sideEvents: SideEventGateway | undefined,
+  endpointKey: string,
+  configId: string,
+  event: LineEvent,
+  logger: ReturnType<typeof getAdapterLogger>,
+): void {
+  if (!sideEvents || !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, {
+    $id: `line:${event.type}:${event.timestamp}:${userId}`,
+    $adapter: 'line' as never,
+    $endpoint: configId,
+    $type: 'notice',
+    $scene_id: conversation.id,
+    $scene_type: parts.scene_type,
+    $sub_type: parts.sub_type,
+    $actor: senderFromId(userId),
+    $timestamp: event.timestamp,
+  })).catch((err) => {
+    logger.warn(formatCompact({
+      op: 'line_side_event_failed',
+      endpoint: configId,
+      event: event.type,
+      error: err instanceof Error ? err.message : String(err),
+    }));
+  });
+}