@zhin.js/adapter-line 2.0.2 → 3.0.0

package/CHANGELOG.md

@@ -1,5 +1,59 @@
 # @zhin.js/adapter-line
 
+## 3.0.0
+
+### Patch Changes
+
+- 7db69c1: 命令前缀改为适配器配置项：`MessageDispatcher` 不再硬编码 `/`，默认按消息所属适配器实例 config 的 `commandPrefix` 解析（默认 `''` 无前缀，任意文本按命令匹配），`endpoints[i].commandPrefix` 逐项覆盖；`ImRuntime({ commandPrefix })` 仍可设全局静态前缀。全部 20 个平台适配器 schema 新增 `commandPrefix` 属性。
+
+  BREAKING（行为变化）：未配置时命令不再需要 `/` 前缀——原 `/zt` 写法不再命中，直接发 `zt` 即可；需要斜杠风格的适配器请在配置里显式设 `commandPrefix: '/'`。
+
+- 713445c: 适配器配置格式定稿（不兼容旧格式）：`plugins.<adapter>` 顶层仅共享字段 + `commandPrefix`，`endpoints[i]` 携带 endpoint 级字段（`name` + 凭据，各 schema 已类型化），`endpoints` 为必填（icqq 另需顶层 `master`）；icqq 新增 `trusted` 列表（顶层/逐项均可）。scaffold-wizard 全部字段式与自定义 configure() 产出改为新格式，examples（full-bot / qq-games-bot）与 20 个适配器 README 同步迁移。
+- Updated dependencies [7db69c1]
+- Updated dependencies [e5c84ed]
+- Updated dependencies [3ea84a0]
+- Updated dependencies [1ddcd70]
+- Updated dependencies [ac9da66]
+  - @zhin.js/core@1.4.0
+  - @zhin.js/adapter@1.1.0
+  - @zhin.js/plugin-runtime@1.1.0
+  - @zhin.js/agent@1.0.5
+  - @zhin.js/host-http@1.0.2
+  - zhin.js@5.0.0
+
+## 2.0.3
+
+### Patch Changes
+
+- cc5c94d: 约定式插件运行时迁移（breaking）：插件与适配器由 `usePlugin()` / `extends Adapter` 迁移为 `definePlugin` / `defineAdapter` + `plugin.ts` + 约定目录（`adapters/`、`commands/`、`components/`、`tools/` 等）。
+
+  - 新增约定式运行时包：`@zhin.js/plugin-runtime`、`@zhin.js/adapter`、`@zhin.js/runtime`、`@zhin.js/host-http`（首版 1.0.0 走 init-publish，不在本 changeset 内 bump）。
+  - 全部 20 个平台适配器改为约定式 `defineAdapter`，旧 `usePlugin` / `extends Adapter` / `segment-mapper` 生产入口已删除；onebot11 反向 WSS、onebot12 webhook/wss、milky sse/webhook/wss、satori webhook、kook webhook、qq webhook/middleware 等 slice 1 推迟的连接模式已补齐。
+  - 游戏 / 工具 / 服务插件同步迁移到约定目录结构。
+  - CLI 增加 plugin-runtime host installer（http/database/outbound/schedule/console 等）。
+
+  后续加固（同批）：
+
+  - CLI：`zhin runtime start --daemon`（pidfile/崩溃拉起/风暴保护），orphan watchdog 防僵尸进程；legacy `zhin dev` / `zhin start` 已移除（含 `zhin restart`），`zhin stop` 兼容新 daemon。
+  - 安全：builtin 工具统一走 `security/policy-facade.ts` 的 `runToolPolicies`（声明式策略表，deny 优先）；审计日志 close flush + 背压队列；`splitCompoundCommand` 引号感知、`extractCommandName` 去引号堵绕过。
+  - 日志：Logger 双堆栈修复、本地时区、`getLogger` 挂树（`setLevel` 递归生效）、第三方库（log4js/discord）桥接、启动人读总结。
+  - 结构：`plugins/games/shared` 迁为 `packages/game-kit`（`@zhin.js/game-kit`）；死目录 `plugins/adapters/common` 删除。
+  - 脚手架：`create-zhin-app` / `zhin new` / scaffold-wizard 生成物改为 Plugin Runtime 形态（minimal-bot 同构，新配置格式）。
+  - Console：endpoint.list 真实名称与 phase、schema:get-all 按 instanceKey 映射、db:\* 接 DatabaseHost。
+
+  注：按仓库发布惯例（见 1bb345dd2），本次 breaking 迁移统一使用 patch，避免 zhin.js 5.0 级联。
+
+- Updated dependencies [16ec4e8]
+- Updated dependencies [cc5c94d]
+- Updated dependencies [447f3e2]
+  - @zhin.js/core@1.3.5
+  - @zhin.js/agent@1.0.4
+  - @zhin.js/host-http@1.0.1
+  - zhin.js@4.1.3
+  - @zhin.js/logger@1.0.75
+  - @zhin.js/plugin-runtime@1.0.1
+  - @zhin.js/adapter@1.0.1
+
 ## 2.0.2
 
 ### Patch Changes

package/README.md

@@ -1,13 +1,31 @@
 # @zhin.js/adapter-line
 
-Zhin.js 适配器 — LINE Messaging API (Webhook 模式)
+Zhin.js LINE Messaging API 适配器（Plugin Runtime），通过 Runtime Host HTTP Webhook 收发消息。
 
 ## 功能
 
-- 接收并解析 LINE Webhook 事件（text、image、video、audio、file、location、sticker）
-- 支持私聊、群组、多人聊天（room）三种场景
-- Reply API / Push API 发送消息
-- HMAC-SHA256 签名验证
+- Webhook 事件接收（`httpHostToken` POST + HMAC-SHA256 签名验证）
+- 解析 text / image / video / audio / file / location / sticker
+- 支持私聊、群组、多人聊天（room）
+- Reply API（有 replyToken 时）/ Push API 发送
+- 约定式 `defineAdapter` / `definePlugin`（无需 `usePlugin`）
+
+## 安装
+
+```bash
+pnpm add @zhin.js/adapter-line
+```
+
+## Plugin Runtime
+
+- `@zhin.js/adapter` — 约定式 `adapters/line.ts`（`defineAdapter`）
+- `@zhin.js/core` — `messageGatewayToken` 入站/出站
+- `@zhin.js/host-http` — `httpHostToken` 注册 Webhook 路由（**非** legacy host-router/Koa）
+- `@zhin.js/plugin-runtime` — `plugin.ts`（`definePlugin`）
+- 配置经插件 `schema.json` 落到 `plugins.<instanceKey>`
+
+入站：`gateway.receive({ adapter, target: channelId, content: text, sender, metadata })`  
+出站：`send({ target, payload })` → Reply API（缓存 replyToken）或 Push API
 
 ## 前置条件
 
@@ -15,20 +33,26 @@ Zhin.js 适配器 — LINE Messaging API (Webhook 模式)
 2. 获取 **Channel Secret** 和 **Channel Access Token**
 3. 设置 Webhook URL 为 `https://your-domain/line/webhook`
 4. 在 Console 中启用 **Use webhooks** 并关闭 **Auto-reply messages**
+5. Runtime Host（`http`）须已 listen，Webhook 才可达
+
+必填字段（`endpoints[i]`）：`name`、`channelSecret`、`channelAccessToken`。
 
 ## 最小配置
 
 ```yaml
-# zhin.config.yml
-adapters:
-  - context: line
-    name: my-line-bot
-    channelSecret: ${LINE_CHANNEL_SECRET}
-    channelAccessToken: ${LINE_CHANNEL_ACCESS_TOKEN}
+# zhin.config.yml（Plugin Runtime）
+plugins:
+  line:
     webhookPath: /line/webhook       # 可选，默认 /line/webhook
     apiBaseUrl: https://api.line.me   # 可选，调试时可改为 LINE API 沙盒地址
+    endpoints:
+      - name: my-line-bot
+        channelSecret: ${LINE_CHANNEL_SECRET}
+        channelAccessToken: ${LINE_CHANNEL_ACCESS_TOKEN}
 ```
 
+根插件 `zhin.plugins`（或项目图）需引用 `@zhin.js/adapter-line`（`instanceKey: line`）。
+
 ## 环境变量
 
 | 变量 | 说明 |
@@ -40,7 +64,7 @@ adapters:
 
 LINE 要求 Webhook URL 以 HTTPS 开头。常见方案：
 
-- **反向代理**：Nginx/Caddy 将 `https://your-domain/line/webhook` 转发到本地 zhIn 端口
+- **反向代理**：Nginx/Caddy 将 `https://your-domain/line/webhook` 转发到本地 zhin 端口
 - **Cloudflare Tunnel**：`cloudflared tunnel --url http://localhost:端口`
 - **ngrok**：调试用 `ngrok http 端口`
 
@@ -48,15 +72,15 @@ LINE 要求 Webhook URL 以 HTTPS 开头。常见方案：
 
 ## 消息类型映射
 
-| LINE 类型 | Zhin.js Segment | 说明 |
-|-----------|----------------|------|
-| text | text | 纯文本 |
-| image | image | 图片（暂不支持二次获取） |
-| video | video | 视频 |
-| audio | audio | 音频 |
-| file | file | 文件 |
-| location | location | 位置信息 |
-| sticker | sticker | 贴纸 |
+| LINE 类型 | 入站 content（文本摘要） | 出站 wire |
+|-----------|--------------------------|-----------|
+| text | 原文 | text |
+| image | `[image]` | image（需 `url`） |
+| video | `[video]` | video（需 `url`） |
+| audio | `[audio]` | audio（需 `url`） |
+| file | `[file: name]` | — |
+| location | address 或坐标 | location |
+| sticker | `[sticker: pkg/id]` | sticker |
 
 ## AI 工具
 
@@ -65,8 +89,6 @@ LINE 要求 Webhook URL 以 HTTPS 开头。常见方案：
 | Permit 词汇 | `agent/PERMITS.md` |
 | 平台工具（2 个） | `agent/tools/`（`line_get_profile`、`line_get_group_members`） |
 | 技能说明 | `agent/skills/line.md` |
-| 群管标准工具 | 覆写 `ISceneManagement` 后由 `createSceneManagementTools()` 注册 |
-
 
 ## 已知限制
 
@@ -79,7 +101,7 @@ LINE 要求 Webhook URL 以 HTTPS 开头。常见方案：
 
 | 问题 | 排查方法 |
 |------|---------|
-| Webhook Verify 失败 | 检查 HTTPS 证书、域名解析、端口是否可达 |
+| Webhook Verify 失败 | 检查 HTTPS 证书、域名解析、端口是否可达；确认 host-http 已 listen |
 | 签名验证 403 | 确认 Channel Secret 与 Console 一致 |
 | 发送 401 | 确认 Channel Access Token 未过期 |
 | 发送 400 | 检查消息格式是否符合 LINE API 规范 |

package/adapters/line.ts

@@ -0,0 +1,26 @@
+/**
+ * Convention entry: discover `adapters/line.ts` → defineAdapter.
+ */
+import { defineAdapter } from '@zhin.js/adapter';
+import { messageGatewayToken } from '@zhin.js/core/runtime';
+import { httpHostToken } from '@zhin.js/host-http';
+import { LineEndpoint } from '../src/endpoint.js';
+import {
+  resolveLineConfig,
+  type LineAdapterConfig,
+} from '../src/protocol.js';
+
+export { LineEndpoint } from '../src/endpoint.js';
+export type { LineEndpointOptions, LineFetch } from '../src/endpoint.js';
+
+export default defineAdapter<LineAdapterConfig>({
+  capabilities: ['inbound', 'outbound'],
+  create(context) {
+    return new LineEndpoint({
+      id: context.id,
+      gateway: context.use(messageGatewayToken),
+      http: context.use(httpHostToken),
+      config: resolveLineConfig(context.config),
+    });
+  },
+});

package/agent/tools/get_group_members.ts

@@ -1,8 +1,8 @@
-import { defineTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
 import { getLineApiConfig } from '../../src/line-agent-deps.js';
 
-export default defineTool<{ groupId: string }>({
+export default defineAgentTool<{ groupId: string }>({
   description: 'Get LINE group member IDs',
   inputSchema: z.object({
     groupId: z.string().min(1),

package/agent/tools/get_profile.ts

@@ -1,8 +1,8 @@
-import { defineTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
 import { getLineApiConfig } from '../../src/line-agent-deps.js';
 
-export default defineTool<{ userId: string }>({
+export default defineAgentTool<{ userId: string }>({
   description: 'Get LINE user profile by userId',
   inputSchema: z.object({
     userId: z.string().min(1),

package/lib/endpoint.d.ts

@@ -0,0 +1,46 @@
+/**
+ * LineEndpoint — lifecycle, outbound, admit, OpenAPI helpers for agent tools.
+ */
+import type { EndpointInstance } from '@zhin.js/adapter';
+import type { MessageGateway } from '@zhin.js/core/runtime';
+import type { HttpHost } from '@zhin.js/host-http';
+import type { CapabilityId } from '@zhin.js/plugin-runtime';
+import { type LineEvent, type ResolvedLineConfig } from './protocol.js';
+export type LineFetch = (url: string, init?: {
+    readonly method?: string;
+    readonly headers?: Record<string, string>;
+    readonly body?: string;
+}) => Promise<{
+    readonly ok: boolean;
+    readonly status: number;
+    text(): Promise<string>;
+    json(): Promise<unknown>;
+}>;
+export interface LineEndpointOptions {
+    readonly id: CapabilityId;
+    readonly gateway: MessageGateway;
+    readonly http: HttpHost;
+    readonly config: ResolvedLineConfig;
+    readonly fetch?: LineFetch;
+}
+export declare class LineEndpoint implements EndpointInstance {
+    #private;
+    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;
+    stop(): Promise<void>;
+    send({ target, payload }: {
+        readonly target: string;
+        readonly payload: unknown;
+    }): Promise<string>;
+    /** Test / internal: admit a parsed event when open (non-webhook path). */
+    admit(event: LineEvent): void;
+}

package/lib/endpoint.js

@@ -0,0 +1,144 @@
+import { formatCompact, getLogger } from '@zhin.js/logger';
+import { registerLineAgentEndpoint } from './line-agent-deps.js';
+import { formatInboundContent, formatOutboundMessages, generateMessageId, isMessageEvent, isValidLineRecipientId, resolveChannel, } from './protocol.js';
+import { registerLineWebhookRoutes } from './webhook.js';
+const logger = getLogger('line');
+export class LineEndpoint {
+    #options;
+    #fetch;
+    #routeReleases = [];
+    #replyTokenCache = new Map();
+    #open = false;
+    #started = false;
+    #unregisterAgent;
+    constructor(options) {
+        this.#options = options;
+        this.#fetch = options.fetch ?? globalThis.fetch;
+    }
+    /** Used by webhook handler. */
+    get isOpen() {
+        return this.#open;
+    }
+    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.name, this);
+            this.#routeReleases.push(...registerLineWebhookRoutes(this.#options.http, this));
+            logger.debug(formatCompact({
+                endpoint: this.#options.config.name,
+                op: 'webhook',
+                path: this.#options.config.webhookPath,
+            }));
+        }
+        catch (error) {
+            await this.stop();
+            logger.error('Failed to connect LINE endpoint:', error);
+            throw error;
+        }
+    }
+    open() {
+        this.#open = true;
+    }
+    close() {
+        this.#open = false;
+    }
+    async stop() {
+        this.#open = false;
+        this.#replyTokenCache.clear();
+        for (const release of this.#routeReleases.splice(0))
+            release();
+        this.#unregisterAgent?.();
+        this.#unregisterAgent = undefined;
+        this.#started = false;
+        logger.debug(formatCompact({ op: 'disconnect', endpoint: this.#options.config.name }));
+    }
+    async send({ target, payload }) {
+        const messages = formatOutboundMessages(payload);
+        if (messages.length === 0) {
+            throw new Error('No valid LINE messages to send');
+        }
+        const replyToken = this.#replyTokenCache.get(target);
+        if (replyToken) {
+            this.#replyTokenCache.delete(target);
+            return this.#replyMessage(replyToken, messages);
+        }
+        if (!isValidLineRecipientId(target)) {
+            throw new Error(`Invalid LINE recipient ID "${target}": must start with U (user), G (group), or R (room)`);
+        }
+        return this.#pushMessage(target, messages);
+    }
+    /** Test / internal: admit a parsed event when open (non-webhook path). */
+    admit(event) {
+        if (!this.#open)
+            return;
+        const { channelId } = resolveChannel(event.source);
+        if ('replyToken' in event && typeof event.replyToken === 'string') {
+            this.#replyTokenCache.set(channelId, event.replyToken);
+        }
+        void this.#options.gateway.receive({
+            adapter: this.#options.id,
+            target: channelId,
+            content: formatInboundContent(event),
+            sender: event.source.userId || channelId,
+            id: generateMessageId(event),
+            metadata: Object.freeze({
+                eventType: event.type,
+                sourceType: event.source.type,
+                endpoint: this.#options.config.name,
+                timestamp: event.timestamp,
+                ...(isMessageEvent(event) ? { messageType: event.message.type } : {}),
+            }),
+        }).catch((err) => {
+            logger.warn(formatCompact({
+                op: 'line_gateway_receive_failed',
+                target: channelId,
+                error: err instanceof Error ? err.message : String(err),
+            }));
+        });
+    }
+    async #replyMessage(replyToken, messages) {
+        const url = `${this.#options.config.apiBaseUrl}/v2/bot/message/reply`;
+        const response = await this.#fetch(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${this.#options.config.channelAccessToken}`,
+            },
+            body: JSON.stringify({ replyToken, messages }),
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`LINE Reply API error ${response.status}: ${errorText}`);
+        }
+        const result = await response.json();
+        return result.sentMessages?.[0]?.id || `reply-${Date.now()}`;
+    }
+    async #pushMessage(to, messages) {
+        const url = `${this.#options.config.apiBaseUrl}/v2/bot/message/push`;
+        const response = await this.#fetch(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${this.#options.config.channelAccessToken}`,
+            },
+            body: JSON.stringify({ to, messages }),
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`LINE Push API error ${response.status}: ${errorText}`);
+        }
+        const result = await response.json();
+        return result.sentMessages?.[0]?.id || `push-${Date.now()}`;
+    }
+}

package/lib/index.d.ts

@@ -0,0 +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';

package/lib/index.js

@@ -0,0 +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';

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

@@ -0,0 +1,24 @@
+/**
+ * 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(endpointId: 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

@@ -0,0 +1,33 @@
+/**
+ * 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(endpointId, endpoint) {
+    endpoints.set(endpointId, endpoint);
+    return () => {
+        if (endpoints.get(endpointId) === endpoint) {
+            endpoints.delete(endpointId);
+        }
+    };
+}
+/** 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/lib/protocol.d.ts

@@ -0,0 +1,151 @@
+/**
+ * LINE Messaging API protocol helpers — no legacy Adapter/Endpoint / segment-mapper.
+ * Canonicalization is owned by gateway/core before endpoint.send.
+ */
+import type { IncomingMessage } from 'node:http';
+/** Plugin Runtime owner config (`plugins.<instanceKey>` / schema.json). */
+export interface LineAdapterConfig {
+    readonly name?: string;
+    readonly channelSecret?: string;
+    readonly channelAccessToken?: string;
+    readonly webhookPath?: string;
+    readonly apiBaseUrl?: string;
+    /** Transitional: legacy root `endpoints[]` with `context: line`. */
+    readonly endpoints?: ReadonlyArray<Partial<ResolvedLineConfig> & {
+        readonly context?: string;
+    }>;
+}
+export interface ResolvedLineConfig {
+    readonly context: 'line';
+    readonly name: string;
+    readonly channelSecret: string;
+    readonly channelAccessToken: string;
+    readonly webhookPath: string;
+    readonly apiBaseUrl: string;
+}
+export interface LineUser {
+    readonly userId: string;
+    readonly displayName?: string;
+    readonly pictureUrl?: string;
+    readonly statusMessage?: string;
+}
+export interface LineMessageEvent {
+    readonly type: 'message';
+    readonly replyToken: string;
+    readonly source: LineSource;
+    readonly timestamp: number;
+    readonly message: LineMessage;
+}
+export interface LineFollowEvent {
+    readonly type: 'follow';
+    readonly replyToken: string;
+    readonly source: LineSource;
+    readonly timestamp: number;
+}
+export interface LineUnfollowEvent {
+    readonly type: 'unfollow';
+    readonly source: LineSource;
+    readonly timestamp: number;
+}
+export interface LineJoinEvent {
+    readonly type: 'join';
+    readonly replyToken: string;
+    readonly source: LineSource;
+    readonly timestamp: number;
+}
+export interface LineLeaveEvent {
+    readonly type: 'leave';
+    readonly source: LineSource;
+    readonly timestamp: number;
+}
+export interface LinePostbackEvent {
+    readonly type: 'postback';
+    readonly replyToken: string;
+    readonly source: LineSource;
+    readonly timestamp: number;
+    readonly postback: {
+        readonly data: string;
+        readonly params?: Record<string, string>;
+    };
+}
+export type LineEvent = LineMessageEvent | LineFollowEvent | LineUnfollowEvent | LineJoinEvent | LineLeaveEvent | LinePostbackEvent;
+export interface LineSource {
+    readonly type: 'user' | 'group' | 'room';
+    readonly userId?: string;
+    readonly groupId?: string;
+    readonly roomId?: string;
+}
+export interface LineMessage {
+    readonly id: string;
+    readonly type: 'text' | 'image' | 'video' | 'audio' | 'file' | 'location' | 'sticker';
+    readonly text?: string;
+    readonly fileName?: string;
+    readonly fileSize?: number;
+    readonly title?: string;
+    readonly address?: string;
+    readonly latitude?: number;
+    readonly longitude?: number;
+    readonly packageId?: string;
+    readonly stickerId?: string;
+    readonly stickerResourceType?: string;
+    readonly duration?: number;
+}
+export interface LineWebhookBody {
+    readonly destination: string;
+    readonly events: readonly LineEvent[];
+}
+export interface LineReplyMessage {
+    readonly type: 'text' | 'image' | 'video' | 'audio' | 'location' | 'sticker' | 'flex';
+    readonly text?: string;
+    readonly originalContentUrl?: string;
+    readonly previewImageUrl?: string;
+    readonly packageId?: string;
+    readonly stickerId?: string;
+    readonly title?: string;
+    readonly address?: string;
+    readonly latitude?: number;
+    readonly longitude?: number;
+    readonly duration?: number;
+    readonly altText?: string;
+    readonly contents?: Record<string, unknown>;
+}
+export interface LineReplyRequest {
+    readonly replyToken: string;
+    readonly messages: readonly LineReplyMessage[];
+}
+export interface LinePushRequest {
+    readonly to: string;
+    readonly messages: readonly LineReplyMessage[];
+}
+export interface LineApiResponse {
+    readonly sentMessages?: ReadonlyArray<{
+        readonly id: string;
+        readonly quoteToken?: string;
+    }>;
+}
+export interface LineWireSegment {
+    readonly type: string;
+    readonly data?: Record<string, unknown>;
+}
+export interface LineChannel {
+    readonly channelType: 'private' | 'group' | 'channel';
+    readonly channelId: string;
+}
+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 isPostbackEvent(event: LineEvent): event is LinePostbackEvent;
+export declare function resolveChannel(source: LineSource): LineChannel;
+export declare function generateMessageId(event: LineEvent): string;
+/** Build inbound text for MessageGateway.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;
+/**
+ * Wire-encode an already-rendered outbound payload into LINE Reply/Push messages.
+ * Segment canonicalization is intentionally not done here.
+ */
+export declare function formatOutboundMessages(payload: unknown): LineReplyMessage[];
+export declare function readTextBody(request: IncomingMessage, options?: {
+    readonly limit?: number;
+}): Promise<string>;