@zhin.js/adapter-line 1.1.4 → 1.1.6

package/CHANGELOG.md

@@ -1,5 +1,46 @@
 # @zhin.js/adapter-line
 
+## 1.1.6
+
+### Patch Changes
+
+- Updated dependencies [badcc1f]
+  - @zhin.js/core@1.1.41
+  - @zhin.js/feature-kit@1.1.3
+  - @zhin.js/adapter@1.1.17
+  - @zhin.js/agent-feature@1.1.4
+  - @zhin.js/skill@1.1.4
+  - @zhin.js/tool@1.1.4
+  - @zhin.js/host-http@1.1.4
+
+## 1.1.5
+
+### Patch Changes
+
+- b9b3953: Stop synthesizing message IDs after outbound API calls. Missing real platform IDs now report an unknown delivery outcome and must not be retried automatically. DingTalk webhook success responses without a message ID therefore remain unconfirmed under the current receipt contract.
+
+  LINE reply and push use their actual sentMessages IDs. Reply HTTP 400 errors no longer trigger automatic push fallback: rejected or partially successful replies could otherwise duplicate a message. Locally expired cached reply tokens still select push before a reply request is made.
+
+- b9b3953: Deduplicate concurrent and completed LINE webhook event IDs within the endpoint instance, retaining successful admission for 24 hours with a bounded cache. Failed admission remains retryable; stop clears the cache. Document that this does not provide persistent or exactly-once business processing.
+- Updated dependencies [b9b3953]
+- Updated dependencies [b9b3953]
+- Updated dependencies [b9b3953]
+- Updated dependencies [b9b3953]
+- Updated dependencies [b9b3953]
+- Updated dependencies [b9b3953]
+- Updated dependencies [b9b3953]
+- Updated dependencies [b9b3953]
+- Updated dependencies [b9b3953]
+- Updated dependencies [b9b3953]
+- Updated dependencies [b9b3953]
+  - @zhin.js/adapter@1.1.16
+  - @zhin.js/im-contract@1.1.3
+  - @zhin.js/core@1.1.40
+  - @zhin.js/host-http@1.1.3
+  - @zhin.js/tool@1.1.3
+  - @zhin.js/skill@1.1.3
+  - @zhin.js/agent-feature@1.1.3
+
 ## 1.1.4
 
 ### Patch Changes

package/README.md

@@ -106,3 +106,11 @@ LINE 要求 Webhook URL 以 HTTPS 开头。常见方案：
 | 发送 401 | 确认 Channel Access Token 未过期 |
 | 发送 400 | 检查消息格式是否符合 LINE API 规范 |
 | 事件未到达 | Console 中 Webhook 是否已启用、是否关闭 Auto-reply |
+
+### Webhook 重放边界
+
+实例内按官方 `webhookEventId` 去重：并发重复请求共享同一次 admission；成功后保留 24 小时，失败释放后可重试。缓存最多 10,000 项，满载时拒绝新 admission，由 HTTP 返回 503；不会驱逐正在处理的事件。重复事件不会重新缓存已消费的 replyToken。未提供事件 ID 的旧事件保持原行为。
+
+缓存随端点停止清空，不提供跨重启或跨实例去重；业务处理可能在失败前已有副作用，因此重试仍需业务幂等。Core 的会话事件存储幂等不等同于命令处理幂等。持久去重需要 Host 提供带租约、完成状态及未知状态处理的 inbox，再按端点身份与事件 ID 认领，不能只写一条数据库记录后宣称 exactly-once。
+
+协议依据：[LINE webhook redelivery](https://developers.line.biz/en/docs/messaging-api/receiving-messages/#webhook-redelivery)。

package/lib/endpoint.d.ts

@@ -1,8 +1,7 @@
-import { Endpoint } from 'zhin.js/adapter';
 /**
  * LineEndpoint — lifecycle, outbound, admit, OpenAPI helpers for agent tools.
  */
-import { type EndpointManagement, EndpointSendRequest } from 'zhin.js/adapter';
+import { Endpoint, type EndpointManagement, type 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';
@@ -39,4 +38,6 @@ export declare class LineEndpoint extends Endpoint<LineClient> {
     send({ conversation, payload }: EndpointSendRequest): Promise<string>;
     /** Test / internal: admit a parsed event when open (non-webhook path). */
     admit(event: LineEvent): void;
+    /** Webhook acknowledgement follows actual runtime generation admission. */
+    admitAccepted(event: LineEvent): Promise<void>;
 }

package/lib/endpoint.js

@@ -1,3 +1,7 @@
+import { EndpointDeliveryError } from '@zhin.js/im-contract';
+/**
+ * LineEndpoint — lifecycle, outbound, admit, OpenAPI helpers for agent tools.
+ */
 import { Endpoint } from 'zhin.js/adapter';
 import { formatCompact, getAdapterLogger } from '@zhin.js/logger';
 import { formatInboundContent, formatOutboundMessages, generateMessageId, isLineLifecycleEvent, isMessageEvent, isValidLineRecipientId, lineInboundConversation, } from './protocol.js';
@@ -15,6 +19,7 @@ export class LineEndpoint extends Endpoint {
     #fetch;
     #routeReleases = [];
     #replyTokenCache = new Map();
+    #admissions = new Map();
     #open = false;
     #started = false;
     management = createLineEndpointManagement(this);
@@ -59,46 +64,79 @@ export class LineEndpoint extends Endpoint {
     async stop() {
         this.#open = false;
         this.#replyTokenCache.clear();
+        this.#admissions.clear();
         for (const release of this.#routeReleases.splice(0))
             release();
         this.#started = false;
         this.#logger.debug(formatCompact({ op: 'disconnect' }));
     }
     async send({ conversation, payload }) {
-        const messages = formatOutboundMessages(payload);
-        if (messages.length === 0) {
-            throw new Error('No valid LINE messages to send');
-        }
-        // LINE recipient id 前缀（U/G/R）自带场景信息，原生 id 即投递地址。
-        const target = conversation.id;
-        const cached = this.#replyTokenCache.get(target);
-        if (cached) {
-            this.#replyTokenCache.delete(target);
-            if (Date.now() - cached.timestamp <= REPLY_TOKEN_TTL_MS) {
-                try {
+        try {
+            const messages = formatOutboundMessages(payload);
+            if (messages.length === 0) {
+                throw new EndpointDeliveryError('invalid_payload', 'No valid LINE messages to send', 'not_sent');
+            }
+            // LINE recipient id 前缀（U/G/R）自带场景信息，原生 id 即投递地址。
+            const target = conversation.id;
+            const cached = this.#replyTokenCache.get(target);
+            if (cached) {
+                this.#replyTokenCache.delete(target);
+                if (Date.now() - cached.timestamp <= REPLY_TOKEN_TTL_MS) {
                     return await this.#replyMessage(cached.token, messages);
                 }
-                catch (error) {
-                    // replyToken 过期/失效时 LINE 返回 400，回退 push 保证消息不丢
-                    if (error.status !== 400)
-                        throw error;
-                    this.#logger.warn(formatCompact({
-                        op: 'line_reply_fallback_push',
-                        endpoint: this.#options.config.id,
-                        target,
-                    }));
-                }
             }
+            if (!isValidLineRecipientId(target)) {
+                throw new EndpointDeliveryError('invalid_recipient', `Invalid LINE recipient ID "${target}": must start with U (user), G (group), or R (room)`, 'not_sent');
+            }
+            return await this.#pushMessage(target, messages);
         }
-        if (!isValidLineRecipientId(target)) {
-            throw new Error(`Invalid LINE recipient ID "${target}": must start with U (user), G (group), or R (room)`);
+        catch (error) {
+            if (error instanceof EndpointDeliveryError)
+                throw error;
+            throw new EndpointDeliveryError('delivery_unconfirmed', 'Outbound request outcome is unknown', 'unknown', { cause: error });
         }
-        return this.#pushMessage(target, messages);
     }
     /** Test / internal: admit a parsed event when open (non-webhook path). */
     admit(event) {
         if (!this.#open)
             return;
+        void this.admitAccepted(event).catch((err) => {
+            this.#logger.warn(formatCompact({ op: 'line_gateway_receive_failed', error: err instanceof Error ? err.message : String(err) }));
+        });
+    }
+    /** Webhook acknowledgement follows actual runtime generation admission. */
+    async admitAccepted(event) {
+        if (!this.#open)
+            throw new Error('LINE endpoint is closed');
+        const id = event.webhookEventId;
+        if (typeof id !== 'string' || !id.trim())
+            return this.#dispatchAccepted(event);
+        const now = Date.now();
+        for (const [key, entry] of this.#admissions)
+            if (entry.expires <= now)
+                this.#admissions.delete(key);
+        const existing = this.#admissions.get(id);
+        if (existing)
+            return existing.promise;
+        // Never evict in-flight admissions: overload returns 503 and permits platform retry.
+        if (this.#admissions.size >= 10_000)
+            throw new Error('LINE admission dedup capacity exhausted');
+        const entry = { promise: Promise.resolve().then(() => this.#dispatchAccepted(event)), expires: Infinity };
+        this.#admissions.set(id, entry);
+        try {
+            await entry.promise;
+            if (this.#admissions.get(id) === entry)
+                entry.expires = Date.now() + 24 * 60 * 60 * 1000;
+        }
+        catch (error) {
+            if (this.#admissions.get(id) === entry)
+                this.#admissions.delete(id);
+            throw error;
+        }
+    }
+    async #dispatchAccepted(event) {
+        if (!this.#open)
+            throw new Error('LINE endpoint is closed');
         void this.emitPlatform(event.type || 'event', event).catch((error) => {
             this.#logger.warn(formatCompact({
                 op: 'line_platform_event_failed',
@@ -107,14 +145,14 @@ export class LineEndpoint extends Endpoint {
             }));
         });
         if (isLineLifecycleEvent(event)) {
-            receiveLineSideEvent((name, payload) => this.emit(name, payload), String(this.#options.id), this.#options.config.id, event, this.#logger);
+            await receiveLineSideEvent((name, payload) => this.emitAccepted(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.emit('message.receive', {
+        await this.emitAccepted('message.receive', {
             conversation,
             message: { conversation, id: generateMessageId(event) },
             content: formatInboundContent(event),
@@ -126,12 +164,6 @@ export class LineEndpoint extends Endpoint {
                 timestamp: event.timestamp,
                 ...(isMessageEvent(event) ? { messageType: event.message.type } : {}),
             }),
-        }).catch((err) => {
-            this.#logger.warn(formatCompact({
-                op: 'line_gateway_receive_failed',
-                target: `${conversation.kind}:${conversation.id}`,
-                error: err instanceof Error ? err.message : String(err),
-            }));
         });
     }
     async #replyMessage(replyToken, messages) {
@@ -146,13 +178,10 @@ export class LineEndpoint extends Endpoint {
             signal: AbortSignal.timeout(OUTBOUND_TIMEOUT_MS),
         });
         if (!response.ok) {
-            const errorText = await response.text();
-            const error = new Error(`LINE Reply API error ${response.status}: ${errorText}`);
-            error.status = response.status;
-            throw error;
+            throw await lineResponseError(response);
         }
         const result = await response.json();
-        return result.sentMessages?.[0]?.id || `reply-${Date.now()}`;
+        return requireMessageId(result.sentMessages?.[0]?.id);
     }
     async #pushMessage(to, messages) {
         const url = `${this.#options.config.apiBaseUrl}/v2/bot/message/push`;
@@ -166,11 +195,10 @@ export class LineEndpoint extends Endpoint {
             signal: AbortSignal.timeout(OUTBOUND_TIMEOUT_MS),
         });
         if (!response.ok) {
-            const errorText = await response.text();
-            throw new Error(`LINE Push API error ${response.status}: ${errorText}`);
+            throw await lineResponseError(response);
         }
         const result = await response.json();
-        return result.sentMessages?.[0]?.id || `push-${Date.now()}`;
+        return requireMessageId(result.sentMessages?.[0]?.id);
     }
 }
 function createLineEndpointManagement(endpoint) {
@@ -179,3 +207,21 @@ function createLineEndpointManagement(endpoint) {
         listGroupMembers: (groupId) => endpoint.client.getGroupMembers(groupId),
     });
 }
+async function lineResponseError(response) {
+    // Error responses may carry sentMessages: a failed request can have partial side effects.
+    let body;
+    try {
+        body = await response.json();
+    }
+    catch {
+        return new EndpointDeliveryError('delivery_unconfirmed', `LINE HTTP ${response.status}`, 'unknown');
+    }
+    const disposition = Array.isArray(body?.sentMessages) && body.sentMessages.length > 0
+        ? 'unknown' : response.status >= 400 && response.status < 500 && response.status !== 408 && response.status !== 409 ? 'rejected' : 'unknown';
+    return new EndpointDeliveryError(disposition === 'unknown' ? 'delivery_unconfirmed' : 'platform_rejected', `LINE HTTP ${response.status}`, disposition);
+}
+function requireMessageId(value) {
+    if (typeof value === 'string' && value.trim().length > 0)
+        return value;
+    throw new EndpointDeliveryError('delivery_unconfirmed', 'Platform did not return a real message ID', 'unknown');
+}

package/lib/protocol.d.ts

@@ -65,7 +65,13 @@ export interface LinePostbackEvent {
         readonly params?: Record<string, string>;
     };
 }
-export type LineEvent = LineMessageEvent | LineFollowEvent | LineUnfollowEvent | LineJoinEvent | LineLeaveEvent | LinePostbackEvent;
+export interface LineEventDelivery {
+    readonly webhookEventId?: string;
+    readonly deliveryContext?: {
+        readonly isRedelivery?: boolean;
+    };
+}
+export type LineEvent = LineEventDelivery & (LineMessageEvent | LineFollowEvent | LineUnfollowEvent | LineJoinEvent | LineLeaveEvent | LinePostbackEvent);
 export interface LineSource {
     readonly type: 'user' | 'group' | 'room';
     readonly userId?: string;

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

@@ -1,4 +1,4 @@
 import type { EndpointEventEmitter } from 'zhin.js/adapter';
 import { type getAdapterLogger } from '@zhin.js/logger';
 import { type LineEvent } from './protocol.js';
-export declare function receiveLineSideEvent(emit: EndpointEventEmitter, 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>): Promise<unknown>;

package/lib/side-event-dispatch.js

@@ -17,11 +17,11 @@ function mapLineLifecycleParts(type) {
 }
 export function receiveLineSideEvent(emit, endpointKey, configId, event, logger) {
     if (!isLineLifecycleEvent(event))
-        return;
+        return Promise.resolve();
     const parts = mapLineLifecycleParts(event.type);
     const conversation = lineInboundConversation(endpointKey, event.source);
     const userId = event.source.userId || conversation.id;
-    void emit('notice.receive', buildNotice(event, {
+    return emit('notice.receive', buildNotice(event, {
         id: `line:${event.type}:${event.timestamp}:${userId}`,
         clientAdapter: 'line',
         endpointId: configId,
@@ -37,5 +37,6 @@ export function receiveLineSideEvent(emit, endpointKey, configId, event, logger)
             event: event.type,
             error: err instanceof Error ? err.message : String(err),
         }));
+        throw err;
     });
 }

package/lib/webhook.d.ts

@@ -8,6 +8,7 @@ export interface LineWebhookHandler {
     readonly config: ResolvedLineConfig;
     readonly isOpen: boolean;
     admit(event: LineEvent): void;
+    admitAccepted(event: LineEvent): Promise<void>;
 }
 export declare function registerLineWebhookRoutes(http: HttpHost, handler: LineWebhookHandler): HttpRouteRegistration[];
 export declare function handleLineWebhookRequest(request: IncomingMessage, response: ServerResponse, handler: LineWebhookHandler): Promise<void>;

package/lib/webhook.js

@@ -30,21 +30,29 @@ export async function handleLineWebhookRequest(request, response, handler) {
             body = JSON.parse(rawBody);
         }
         catch {
-            response.writeHead(200, { 'Content-Type': 'application/json' });
-            response.end(JSON.stringify({ message: 'OK' }));
+            response.writeHead(400, { 'Content-Type': 'application/json' });
+            response.end(JSON.stringify({ message: 'Invalid JSON' }));
             return;
         }
-        if (handler.isOpen && Array.isArray(body.events)) {
-            for (const event of body.events) {
-                handler.admit(event);
-            }
+        if (!body || !Array.isArray(body.events) || body.events.some(event => !event || typeof event.type !== 'string' || !event.source || !['user', 'group', 'room'].includes(event.source.type) || (event.type === 'message' && !('message' in event && event.message && typeof event.message.id === 'string')))) {
+            response.writeHead(400, { 'Content-Type': 'application/json' });
+            response.end(JSON.stringify({ message: 'Invalid events' }));
+            return;
+        }
+        if (body.events.length && !handler.isOpen) {
+            response.writeHead(503, { 'Content-Type': 'application/json' });
+            response.end(JSON.stringify({ message: 'Endpoint unavailable' }));
+            return;
+        }
+        for (const event of body.events) {
+            await handler.admitAccepted(event);
         }
         response.writeHead(200, { 'Content-Type': 'application/json' });
         response.end(JSON.stringify({ message: 'OK' }));
     }
     catch (error) {
         logger.error('LINE webhook error:', error);
-        response.writeHead(200, { 'Content-Type': 'application/json' });
-        response.end(JSON.stringify({ message: 'OK' }));
+        response.writeHead(503, { 'Content-Type': 'application/json' });
+        response.end(JSON.stringify({ message: 'Admission unavailable' }));
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-line",
-  "version": "1.1.4",
+  "version": "1.1.6",
   "description": "Zhin.js LINE Messaging API adapter for Plugin Runtime (HTTP webhook)",
   "type": "module",
   "main": "./lib/index.js",
@@ -32,23 +32,23 @@
     "directory": "plugins/adapters/line"
   },
   "dependencies": {
-    "@zhin.js/adapter": "1.1.15",
-    "@zhin.js/agent-feature": "1.1.2",
-    "@zhin.js/core": "1.1.39",
-    "@zhin.js/feature-kit": "1.1.2",
-    "@zhin.js/host-http": "1.1.2",
-    "@zhin.js/im-contract": "1.1.2",
+    "@zhin.js/adapter": "1.1.17",
+    "@zhin.js/agent-feature": "1.1.4",
+    "@zhin.js/core": "1.1.41",
+    "@zhin.js/feature-kit": "1.1.3",
+    "@zhin.js/host-http": "1.1.4",
+    "@zhin.js/im-contract": "1.1.3",
     "@zhin.js/logger": "1.1.1",
-    "@zhin.js/skill": "1.1.2",
-    "@zhin.js/tool": "1.1.2"
+    "@zhin.js/skill": "1.1.4",
+    "@zhin.js/tool": "1.1.4"
   },
   "peerDependencies": {
     "zod": "^4.0.0",
-    "@zhin.js/adapter": "^1.1.15",
-    "@zhin.js/command": "^1.1.3",
-    "@zhin.js/core": "^1.1.39",
-    "@zhin.js/host-http": "^1.1.2",
-    "zhin.js": "^1.1.4"
+    "@zhin.js/adapter": "^1.1.17",
+    "@zhin.js/command": "^1.1.5",
+    "@zhin.js/core": "^1.1.41",
+    "@zhin.js/host-http": "^1.1.4",
+    "zhin.js": "^1.1.6"
   },
   "peerDependenciesMeta": {
     "@zhin.js/command": {
@@ -66,7 +66,7 @@
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
     "zod": "^4.4.3",
-    "zhin.js": "1.1.4"
+    "zhin.js": "1.1.6"
   },
   "files": [
     "adapters",

package/src/endpoint.ts

@@ -1,8 +1,8 @@
-import { Endpoint } from 'zhin.js/adapter';
+import { EndpointDeliveryError } from '@zhin.js/im-contract';
 /**
  * LineEndpoint — lifecycle, outbound, admit, OpenAPI helpers for agent tools.
  */
-import { type EndpointManagement, EndpointSendRequest } from 'zhin.js/adapter';
+import { Endpoint, type EndpointManagement, type 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';
@@ -57,6 +57,7 @@ export class LineEndpoint extends Endpoint<LineClient> {
   readonly #fetch: LineFetch;
   #routeReleases: HttpRouteRegistration[] = [];
   #replyTokenCache = new Map<string, { token: string; timestamp: number }>();
+  readonly #admissions = new Map<string, { readonly promise: Promise<void>; expires: number }>();
   #open = false;
   #started = false;
   readonly management: EndpointManagement = createLineEndpointManagement(this);
@@ -106,48 +107,73 @@ export class LineEndpoint extends Endpoint<LineClient> {
   async stop(): Promise<void> {
     this.#open = false;
     this.#replyTokenCache.clear();
+    this.#admissions.clear();
     for (const release of this.#routeReleases.splice(0)) release();
     this.#started = false;
     this.#logger.debug(formatCompact({ op: 'disconnect' }));
   }
 
   async send({ conversation, payload }: EndpointSendRequest): Promise<string> {
-    const messages = formatOutboundMessages(payload);
-    if (messages.length === 0) {
-      throw new Error('No valid LINE messages to send');
-    }
-    // LINE recipient id 前缀（U/G/R）自带场景信息，原生 id 即投递地址。
-    const target = conversation.id;
-
-    const cached = this.#replyTokenCache.get(target);
-    if (cached) {
-      this.#replyTokenCache.delete(target);
-      if (Date.now() - cached.timestamp <= REPLY_TOKEN_TTL_MS) {
-        try {
+    try {
+      const messages = formatOutboundMessages(payload);
+      if (messages.length === 0) {
+        throw new EndpointDeliveryError('invalid_payload', 'No valid LINE messages to send', 'not_sent');
+      }
+      // LINE recipient id 前缀（U/G/R）自带场景信息，原生 id 即投递地址。
+      const target = conversation.id;
+
+      const cached = this.#replyTokenCache.get(target);
+      if (cached) {
+        this.#replyTokenCache.delete(target);
+        if (Date.now() - cached.timestamp <= REPLY_TOKEN_TTL_MS) {
           return await this.#replyMessage(cached.token, messages);
-        } catch (error) {
-          // replyToken 过期/失效时 LINE 返回 400，回退 push 保证消息不丢
-          if ((error as { status?: number }).status !== 400) throw error;
-          this.#logger.warn(formatCompact({
-            op: 'line_reply_fallback_push',
-            endpoint: this.#options.config.id,
-            target,
-          }));
         }
       }
-    }
 
-    if (!isValidLineRecipientId(target)) {
-      throw new Error(
-        `Invalid LINE recipient ID "${target}": must start with U (user), G (group), or R (room)`,
-      );
+      if (!isValidLineRecipientId(target)) {
+        throw new EndpointDeliveryError('invalid_recipient',
+          `Invalid LINE recipient ID "${target}": must start with U (user), G (group), or R (room)`, 'not_sent',
+        );
+      }
+      return await this.#pushMessage(target, messages);
+    } catch (error) {
+      if (error instanceof EndpointDeliveryError) throw error;
+      throw new EndpointDeliveryError('delivery_unconfirmed', 'Outbound request outcome is unknown', 'unknown', { cause: error });
     }
-    return this.#pushMessage(target, messages);
   }
 
   /** Test / internal: admit a parsed event when open (non-webhook path). */
   admit(event: LineEvent): void {
     if (!this.#open) return;
+    void this.admitAccepted(event).catch((err) => {
+      this.#logger.warn(formatCompact({ op: 'line_gateway_receive_failed', error: err instanceof Error ? err.message : String(err) }));
+    });
+  }
+
+  /** Webhook acknowledgement follows actual runtime generation admission. */
+  async admitAccepted(event: LineEvent): Promise<void> {
+    if (!this.#open) throw new Error('LINE endpoint is closed');
+    const id = event.webhookEventId;
+    if (typeof id !== 'string' || !id.trim()) return this.#dispatchAccepted(event);
+    const now = Date.now();
+    for (const [key, entry] of this.#admissions) if (entry.expires <= now) this.#admissions.delete(key);
+    const existing = this.#admissions.get(id);
+    if (existing) return existing.promise;
+    // Never evict in-flight admissions: overload returns 503 and permits platform retry.
+    if (this.#admissions.size >= 10_000) throw new Error('LINE admission dedup capacity exhausted');
+    const entry = { promise: Promise.resolve().then(() => this.#dispatchAccepted(event)), expires: Infinity };
+    this.#admissions.set(id, entry);
+    try {
+      await entry.promise;
+      if (this.#admissions.get(id) === entry) entry.expires = Date.now() + 24 * 60 * 60 * 1000;
+    } catch (error) {
+      if (this.#admissions.get(id) === entry) this.#admissions.delete(id);
+      throw error;
+    }
+  }
+
+  async #dispatchAccepted(event: LineEvent): Promise<void> {
+    if (!this.#open) throw new Error('LINE endpoint is closed');
     void this.emitPlatform(event.type || 'event', event).catch((error) => {
       this.#logger.warn(formatCompact({
         op: 'line_platform_event_failed',
@@ -156,8 +182,8 @@ export class LineEndpoint extends Endpoint<LineClient> {
       }));
     });
     if (isLineLifecycleEvent(event)) {
-      receiveLineSideEvent(
-        (name, payload) => this.emit(name, payload),
+      await receiveLineSideEvent(
+        (name, payload) => this.emitAccepted(name, payload),
         String(this.#options.id),
         this.#options.config.id,
         event,
@@ -169,7 +195,7 @@ export class LineEndpoint extends Endpoint<LineClient> {
     if ('replyToken' in event && typeof event.replyToken === 'string') {
       this.#replyTokenCache.set(conversation.id, { token: event.replyToken, timestamp: Date.now() });
     }
-    void this.emit('message.receive', {
+    await this.emitAccepted('message.receive', {
       conversation,
       message: { conversation, id: generateMessageId(event) },
       content: formatInboundContent(event),
@@ -181,12 +207,6 @@ export class LineEndpoint extends Endpoint<LineClient> {
         timestamp: event.timestamp,
         ...(isMessageEvent(event) ? { messageType: event.message.type } : {}),
       }),
-    }).catch((err) => {
-      this.#logger.warn(formatCompact({
-        op: 'line_gateway_receive_failed',
-        target: `${conversation.kind}:${conversation.id}`,
-        error: err instanceof Error ? err.message : String(err),
-      }));
     });
   }
 
@@ -205,13 +225,10 @@ export class LineEndpoint extends Endpoint<LineClient> {
       signal: AbortSignal.timeout(OUTBOUND_TIMEOUT_MS),
     });
     if (!response.ok) {
-      const errorText = await response.text();
-      const error = new Error(`LINE Reply API error ${response.status}: ${errorText}`) as Error & { status?: number };
-      error.status = response.status;
-      throw error;
+      throw await lineResponseError(response);
     }
     const result = await response.json() as LineApiResponse;
-    return result.sentMessages?.[0]?.id || `reply-${Date.now()}`;
+    return requireMessageId(result.sentMessages?.[0]?.id);
   }
 
   async #pushMessage(
@@ -229,11 +246,10 @@ export class LineEndpoint extends Endpoint<LineClient> {
       signal: AbortSignal.timeout(OUTBOUND_TIMEOUT_MS),
     });
     if (!response.ok) {
-      const errorText = await response.text();
-      throw new Error(`LINE Push API error ${response.status}: ${errorText}`);
+      throw await lineResponseError(response);
     }
     const result = await response.json() as LineApiResponse;
-    return result.sentMessages?.[0]?.id || `push-${Date.now()}`;
+    return requireMessageId(result.sentMessages?.[0]?.id);
   }
 
   /**
@@ -249,3 +265,18 @@ function createLineEndpointManagement(endpoint: LineEndpoint): EndpointManagemen
     listGroupMembers: (groupId) => endpoint.client.getGroupMembers(groupId),
   });
 }
+
+async function lineResponseError(response: Awaited<ReturnType<LineFetch>>): Promise<EndpointDeliveryError> {
+  // Error responses may carry sentMessages: a failed request can have partial side effects.
+  let body: { sentMessages?: unknown[] };
+  try { body = await response.json() as { sentMessages?: unknown[] }; }
+  catch { return new EndpointDeliveryError('delivery_unconfirmed', `LINE HTTP ${response.status}`, 'unknown'); }
+  const disposition = Array.isArray(body?.sentMessages) && body.sentMessages.length > 0
+    ? 'unknown' : response.status >= 400 && response.status < 500 && response.status !== 408 && response.status !== 409 ? 'rejected' : 'unknown';
+  return new EndpointDeliveryError(disposition === 'unknown' ? 'delivery_unconfirmed' : 'platform_rejected', `LINE HTTP ${response.status}`, disposition);
+}
+
+function requireMessageId(value: unknown): string {
+  if (typeof value === 'string' && value.trim().length > 0) return value;
+  throw new EndpointDeliveryError('delivery_unconfirmed', 'Platform did not return a real message ID', 'unknown');
+}

package/src/protocol.ts

@@ -80,13 +80,18 @@ export interface LinePostbackEvent {
   };
 }
 
-export type LineEvent =
+export interface LineEventDelivery {
+  readonly webhookEventId?: string;
+  readonly deliveryContext?: { readonly isRedelivery?: boolean };
+}
+
+export type LineEvent = LineEventDelivery & (
   | LineMessageEvent
   | LineFollowEvent
   | LineUnfollowEvent
   | LineJoinEvent
   | LineLeaveEvent
-  | LinePostbackEvent;
+  | LinePostbackEvent);
 
 export interface LineSource {
   readonly type: 'user' | 'group' | 'room';

package/src/side-event-dispatch.ts

@@ -28,12 +28,12 @@ export function receiveLineSideEvent(
   configId: string,
   event: LineEvent,
   logger: ReturnType<typeof getAdapterLogger>,
-): void {
-  if (!isLineLifecycleEvent(event)) return;
+): Promise<unknown> {
+  if (!isLineLifecycleEvent(event)) return Promise.resolve();
   const parts = mapLineLifecycleParts(event.type);
   const conversation = lineInboundConversation(endpointKey, event.source);
   const userId = event.source.userId || conversation.id;
-  void emit('notice.receive', buildNotice(event, {
+  return emit('notice.receive', buildNotice(event, {
     id: `line:${event.type}:${event.timestamp}:${userId}`,
     clientAdapter: 'line',
     endpointId: configId,
@@ -49,5 +49,6 @@ export function receiveLineSideEvent(
       event: event.type,
       error: err instanceof Error ? err.message : String(err),
     }));
+    throw err;
   });
 }

package/src/webhook.ts

@@ -18,6 +18,7 @@ export interface LineWebhookHandler {
   readonly config: ResolvedLineConfig;
   readonly isOpen: boolean;
   admit(event: LineEvent): void;
+  admitAccepted(event: LineEvent): Promise<void>;
 }
 
 export function registerLineWebhookRoutes(
@@ -58,22 +59,30 @@ export async function handleLineWebhookRequest(
     try {
       body = JSON.parse(rawBody) as LineWebhookBody;
     } catch {
-      response.writeHead(200, { 'Content-Type': 'application/json' });
-      response.end(JSON.stringify({ message: 'OK' }));
+      response.writeHead(400, { 'Content-Type': 'application/json' });
+      response.end(JSON.stringify({ message: 'Invalid JSON' }));
       return;
     }
 
-    if (handler.isOpen && Array.isArray(body.events)) {
-      for (const event of body.events) {
-        handler.admit(event);
-      }
+    if (!body || !Array.isArray(body.events) || body.events.some(event => !event || typeof event.type !== 'string' || !event.source || !['user', 'group', 'room'].includes(event.source.type) || (event.type === 'message' && !('message' in event && event.message && typeof event.message.id === 'string')))) {
+      response.writeHead(400, { 'Content-Type': 'application/json' });
+      response.end(JSON.stringify({ message: 'Invalid events' }));
+      return;
+    }
+    if (body.events.length && !handler.isOpen) {
+      response.writeHead(503, { 'Content-Type': 'application/json' });
+      response.end(JSON.stringify({ message: 'Endpoint unavailable' }));
+      return;
+    }
+    for (const event of body.events) {
+      await handler.admitAccepted(event);
     }
 
     response.writeHead(200, { 'Content-Type': 'application/json' });
     response.end(JSON.stringify({ message: 'OK' }));
   } catch (error) {
     logger.error('LINE webhook error:', error);
-    response.writeHead(200, { 'Content-Type': 'application/json' });
-    response.end(JSON.stringify({ message: 'OK' }));
+    response.writeHead(503, { 'Content-Type': 'application/json' });
+    response.end(JSON.stringify({ message: 'Admission unavailable' }));
   }
 }