@zhin.js/adapter-line 1.1.0 → 1.1.2

package/CHANGELOG.md

@@ -1,5 +1,98 @@
 # @zhin.js/adapter-line
 
+## 1.1.2
+
+### Patch Changes
+
+- a9e4a40: Derive Command user routes only from explicit `commands/**/*/index.ts(x)` entry paths instead of prepending the plugin owner. Child plugins can now publish top-level static or dynamic commands, while duplicate routes across owners fail during generation construction. Adapter endpoint commands move to explicit paths such as `commands/qq/endpoint/list/index.ts` and are invoked as `qq endpoint list`.
+- 8740059: Standardize TypeScript capabilities on named module directories such as `commands/foo/index.ts`, `middlewares/audit/index.ts`, `handlers/message-receive/index.ts`, `pages/workroom/index.tsx`, and `mcps/filesystem/index.ts`. Only the fixed `index` entry is discovered; sibling files remain private helpers.
+
+  Command route segments come from directories, while `[name]`, `[[name]]`, `[...name]`, and `[[...name]]` directories declare dynamic parameters. Plugin owners do not enter the route unless their config explicitly sets `commandNamespace`; Endpoint `commandPrefix` remains platform-owned and defaults to an empty string.
+
+  Migrate the built-in adapters, plugins, examples, generators, migration tooling, hot reload classification, Agent authoring surfaces, documentation, and release artifacts to the explicit entry convention.
+
+  Make Tool ownership and progressive disclosure explicit across all four supported locations: plugin-public `tools/`, Agent-private `agents/<name>/tools/`, Skill-private `skills/<name>/tools/`, and Agent-Skill-private `agents/<name>/skills/<name>/tools/`. Move adapter and group-suite operations that require domain instructions into their owning Skills so `load_skill` is the only path that unlocks their schemas.
+
+  Remove the package-root `agent/` convention. Public capabilities now use named package-root directories, schedules use `schedules/<name>/index.ts` or `plugin.ts` injection, MCP connections use `mcps/<name>/index.ts`, Prompt Sections use `prompt-sections/<name>/index.ts`, Agent definitions use `agents/<name>/`, and permission vocabulary is published as `PERMITS.md`.
+
+- 25a845a: Unify Skills on `skills/<name>/SKILL.md`, support Agent-private Skills and nested Skill-private Tools, publish and mount existing plugin Skills, add governed Skill metadata and Turn access filtering, unlock only already-admitted same-owner Tools, and make `on-risk` and `once` approval behavior precise.
+- ddbb92e: Isolate adapter Skills under platform-specific Agents and automatically select the matching platform Agent for IM ingress, preventing unrelated adapter Skills from entering another platform's prompt surface.
+- 40d2c8f: Reduce the default Agent Tool surface by moving process diagnostics into a Skill and splitting broad platform Skills into focused task domains. Restore ICQQ friend and group directory tools with `on-risk` approval and explicit owner, administrator, master, or trusted access.
+- 4380cf9: Colocate adapter command definitions and Agent Skill handlers with their owning capabilities, and provide a shared validated platform permission constructor.
+- d8cdff0: Require the canonical expanded LINE endpoint configuration. The protocol no longer reinterprets nested `endpoints` or reads endpoint identity and credentials from `process.env`. The public config type is now `LineEndpointConfig`, and each schema entry uses `id` as its identity.
+- 5c3858e: Make `@zhin.js/im-contract` the explicit zero-dependency owner of transport identities, canonical segments, media guards, conversation facts, stores, and delivery contracts. Platform adapters now read media contracts from that foundation instead of reaching through Core.
+- 33ea736: Use `tools/<name>/index.ts` and `defineAgentTool` from `@zhin.js/tool` as the sole Agent Tool authoring model. Remove the duplicate `@zhin.js/tools` definition, context, bridge, export, and discovery path; migrate plugin manifests, examples, scaffolding, HMR, and prepack compilation to the generation-owned Tool Feature.
+- Updated dependencies [c861789]
+- Updated dependencies [1414ccb]
+- Updated dependencies [743d470]
+- Updated dependencies [62dee52]
+- Updated dependencies [cd54131]
+- Updated dependencies [244e475]
+- Updated dependencies [a9e4a40]
+- Updated dependencies [5855db7]
+- Updated dependencies [ec921d2]
+- Updated dependencies [8740059]
+- Updated dependencies [63d1f7a]
+- Updated dependencies [25a845a]
+- Updated dependencies [103f2c3]
+- Updated dependencies [9110ab8]
+- Updated dependencies [cd2a888]
+- Updated dependencies [eb3227a]
+- Updated dependencies [b853dba]
+- Updated dependencies [e561309]
+- Updated dependencies [d4c6175]
+- Updated dependencies [7a0e1ca]
+- Updated dependencies [103b5d3]
+- Updated dependencies [5a7a7f7]
+- Updated dependencies [b076eae]
+- Updated dependencies [535fed1]
+- Updated dependencies [73a24b7]
+- Updated dependencies [2dbbc15]
+- Updated dependencies [1cb1163]
+- Updated dependencies [be3061e]
+- Updated dependencies [75f8332]
+- Updated dependencies [81935e2]
+- Updated dependencies [f9ed01b]
+- Updated dependencies [ac0ab50]
+- Updated dependencies [5140ce1]
+- Updated dependencies [522d75f]
+- Updated dependencies [a7611b3]
+- Updated dependencies [8823044]
+- Updated dependencies [379439b]
+- Updated dependencies [11c9352]
+- Updated dependencies [6b70e46]
+- Updated dependencies [135ac91]
+- Updated dependencies [140cf0f]
+- Updated dependencies [251e4d2]
+- Updated dependencies [203ad34]
+- Updated dependencies [e6c5113]
+- Updated dependencies [e0f6478]
+- Updated dependencies [baef56b]
+- Updated dependencies [698f16f]
+- Updated dependencies [da0a8e3]
+- Updated dependencies [2fd8017]
+- Updated dependencies [5c3858e]
+- Updated dependencies [33ea736]
+- Updated dependencies [507d602]
+- Updated dependencies [df9f76b]
+  - @zhin.js/core@1.1.37
+  - @zhin.js/tool@1.1.1
+  - @zhin.js/host-http@1.1.1
+  - @zhin.js/adapter@1.1.14
+  - @zhin.js/feature-kit@1.1.1
+  - @zhin.js/agent-feature@1.1.1
+  - @zhin.js/skill@1.1.1
+  - @zhin.js/logger@1.1.1
+  - @zhin.js/im-contract@1.1.1
+
+## 1.1.1
+
+### Patch Changes
+
+- Updated dependencies [769e67f]
+  - @zhin.js/adapter@1.1.13
+  - @zhin.js/core@1.1.36
+
 ## 1.1.0
 
 ### Minor Changes

package/README.md

@@ -18,7 +18,7 @@ pnpm add @zhin.js/adapter-line
 
 ## Plugin Runtime
 
-- `@zhin.js/adapter` — 约定式 `adapters/line.ts`（`defineAdapter`）
+- `@zhin.js/adapter` — 约定式 `adapters/line/index.ts`（`defineAdapter`）
 - `@zhin.js/core` — `Endpoint.emit(...)` 入站、`outboundMessageToken` 出站
 - `@zhin.js/host-http` — `httpHostToken` 注册 Webhook 路由（**非** legacy host-router/Koa）
 - `zhin.js` — `plugin.ts`（`definePlugin`）
@@ -35,7 +35,7 @@ pnpm add @zhin.js/adapter-line
 4. 在 Console 中启用 **Use webhooks** 并关闭 **Auto-reply messages**
 5. Runtime Host（`http`）须已 listen，Webhook 才可达
 
-必填字段（`endpoints[i]`）：`name`、`channelSecret`、`channelAccessToken`。
+必填字段（`endpoints[i]`）：`id`、`channelSecret`、`channelAccessToken`。
 
 ## 最小配置
 
@@ -46,7 +46,7 @@ plugins:
     webhookPath: /line/webhook       # 可选，默认 /line/webhook
     apiBaseUrl: https://api.line.me   # 可选，调试时可改为 LINE API 沙盒地址
     endpoints:
-      - name: my-line-bot
+      - id: my-line-bot
         channelSecret: ${LINE_CHANNEL_SECRET}
         channelAccessToken: ${LINE_CHANNEL_ACCESS_TOKEN}
 ```
@@ -57,8 +57,8 @@ plugins:
 
 | 变量 | 说明 |
 |------|------|
-| `LINE_CHANNEL_SECRET` | Channel Secret（签名验证用） |
-| `LINE_CHANNEL_ACCESS_TOKEN` | Long-lived Channel Access Token（API 调用用） |
+| `LINE_CHANNEL_SECRET` | 示例中由 YAML `${LINE_CHANNEL_SECRET}` 引用的 Channel Secret；变量名可自行定义 |
+| `LINE_CHANNEL_ACCESS_TOKEN` | 示例中由 YAML `${LINE_CHANNEL_ACCESS_TOKEN}` 引用的 Channel Access Token；变量名可自行定义 |
 
 ## Webhook URL 配置
 
@@ -86,9 +86,9 @@ LINE 要求 Webhook URL 以 HTTPS 开头。常见方案：
 
 | 类别 | 路径 |
 |------|------|
-| Permit 词汇 | `agent/PERMITS.md` |
-| 平台工具（2 个） | `agent/tools/`（`line_get_profile`、`line_get_group_members`） |
-| 技能说明 | `agent/skills/line.md` |
+| Permit 词汇 | `PERMITS.md` |
+| 平台工具（2 个） | `tools/`（`line_get_profile`、`line_get_group_members`） |
+| 技能说明 | `agents/line/skills/line/SKILL.md` |
 
 ## 已知限制
 

package/adapters/{line.js → line/index.js}

@@ -1,13 +1,13 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
 /**
- * Convention entry: discover `adapters/line.ts` → defineAdapter.
+ * Convention entry: discover `adapters/line/index.ts` → defineAdapter.
  */
 import { defineAdapter } from 'zhin.js/adapter';
 import { httpHostToken } from '@zhin.js/host-http';
-import { LineEndpoint } from "../lib/endpoint.js";
-import { resolveLineConfig, } from "../lib/protocol.js";
-import { lineRuntimeStateToken } from "../lib/line-runtime-state.js";
-export { LineEndpoint } from "../lib/endpoint.js";
+import { LineEndpoint } from "../../lib/endpoint.js";
+import { resolveLineConfig, } from "../../lib/protocol.js";
+import { lineRuntimeStateToken } from "../../lib/line-runtime-state.js";
+export { LineEndpoint } from "../../lib/endpoint.js";
 export default defineAdapter({
     capabilities: ['inbound', 'outbound'],
     // LINE Messaging API 媒体消息仅消费远程 URL；无按钮交互面，交互段降级纯文本。
@@ -17,7 +17,7 @@ export default defineAdapter({
     },
     create(context) {
         const config = resolveLineConfig(context.config);
-        // 注册到插件运行时状态（line.endpoint list 的"运行中"数据源）
+        // 注册到插件运行时状态（line endpoint list 的"运行中"数据源）
         context.use(lineRuntimeStateToken).endpoints.set(config.id, {
             id: config.id,
             mode: 'webhook',

package/adapters/{line.ts → line/index.ts}

@@ -1,19 +1,19 @@
 /**
- * Convention entry: discover `adapters/line.ts` → defineAdapter.
+ * Convention entry: discover `adapters/line/index.ts` → defineAdapter.
  */
 import { defineAdapter } from 'zhin.js/adapter';
 import { httpHostToken } from '@zhin.js/host-http';
-import { LineEndpoint } from '../src/endpoint.js';
+import { LineEndpoint } from '../../src/endpoint.js';
 import {
   resolveLineConfig,
-  type LineAdapterConfig,
-} from '../src/protocol.js';
-import { lineRuntimeStateToken } from '../src/line-runtime-state.js';
+  type LineEndpointConfig,
+} from '../../src/protocol.js';
+import { lineRuntimeStateToken } from '../../src/line-runtime-state.js';
 
-export { LineEndpoint } from '../src/endpoint.js';
-export type { LineEndpointOptions, LineFetch } from '../src/endpoint.js';
+export { LineEndpoint } from '../../src/endpoint.js';
+export type { LineEndpointOptions, LineFetch } from '../../src/endpoint.js';
 
-export default defineAdapter<LineAdapterConfig>({
+export default defineAdapter<LineEndpointConfig>({
   capabilities: ['inbound', 'outbound'],
   // LINE Messaging API 媒体消息仅消费远程 URL；无按钮交互面，交互段降级纯文本。
   segments: {
@@ -22,7 +22,7 @@ export default defineAdapter<LineAdapterConfig>({
   },
   create(context) {
     const config = resolveLineConfig(context.config);
-    // 注册到插件运行时状态（line.endpoint list 的"运行中"数据源）
+    // 注册到插件运行时状态（line endpoint list 的"运行中"数据源）
     context.use(lineRuntimeStateToken).endpoints.set(config.id, {
       id: config.id,
       mode: 'webhook',

package/agents/line/agent.json

@@ -0,0 +1,20 @@
+{
+  "name": "LINE Platform Agent",
+  "version": "1.0.0",
+  "description": "Handles line platform-specific operations and progressively loads only the required platform Skill.",
+  "trigger_rules": {
+    "file_patterns": [],
+    "keywords": [
+      "line",
+      "adapter:line"
+    ]
+  },
+  "entry_points": [
+    "system.md",
+    "boundaries.md",
+    "conventions.md"
+  ],
+  "platforms": [
+    "line"
+  ]
+}

package/agents/line/boundaries.md

@@ -0,0 +1,3 @@
+# Boundaries
+
+Operate only on the active line endpoint and authenticated conversation context. Respect every Tool permission and approval policy. Do not infer identifiers, roles, or authorization from display names.

package/agents/line/conventions.md

@@ -0,0 +1,3 @@
+# Conventions
+
+Use stable platform identifiers from the current turn or directory queries. Load one task-specific Skill at a time, and use the unified reply and outbound message path.

package/{agent/skills/line.md → agents/line/skills/line/SKILL.md}

@@ -14,6 +14,9 @@ keywords:
 tags:
   - im
   - adapter
+tools:
+  - "get_group_members"
+  - "get_profile"
 ---
 # LINE Messaging API 技能
 

package/agents/line/skills/line/tools/get_group_members/index.js

@@ -0,0 +1,16 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool({
+    description: 'Get LINE group member IDs',
+    adapter: 'line',
+    inputSchema: z.object({
+        groupId: z.string().min(1),
+    }),
+    async execute({ groupId }, context) {
+        if (!groupId.startsWith('G')) {
+            throw new Error(`Invalid groupId "${groupId}": must start with G`);
+        }
+        return context.$client.getGroupMemberIds(groupId);
+    },
+});

package/{agent/tools/get_group_members.ts → agents/line/skills/line/tools/get_group_members/index.ts}

@@ -1,4 +1,4 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
 export default defineAgentTool<{ groupId: string }>({

package/agents/line/skills/line/tools/get_profile/index.js

@@ -0,0 +1,16 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool({
+    description: 'Get LINE user profile by userId',
+    adapter: 'line',
+    inputSchema: z.object({
+        userId: z.string().min(1),
+    }),
+    async execute({ userId }, context) {
+        if (!userId.startsWith('U')) {
+            throw new Error(`Invalid userId "${userId}": must start with U`);
+        }
+        return context.$client.getProfile(userId);
+    },
+});

package/{agent/tools/get_profile.ts → agents/line/skills/line/tools/get_profile/index.ts}

@@ -1,4 +1,4 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
 export default defineAgentTool<{ userId: string }>({

package/agents/line/system.md

@@ -0,0 +1,3 @@
+# LINE Platform Agent
+
+You are the line platform specialist. Interpret requests in the current line conversation and load only the narrowest private Skill needed for the task.

package/commands/{endpoint/add/[id].js → line/endpoint/add/[id]/index.js}

@@ -1,3 +1,3 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
-import { lineEndpointCommands } from "../../../lib/line-endpoint-commands.js";
+import { lineEndpointCommands } from '../../definition.js';
 export default lineEndpointCommands.add;

package/commands/line/endpoint/add/[id]/index.ts

@@ -0,0 +1,3 @@
+import { lineEndpointCommands } from '../../definition.js';
+
+export default lineEndpointCommands.add;

package/{lib/line-endpoint-commands.js → commands/line/endpoint/definition.js}

@@ -1,10 +1,11 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
 /**
- * `line.endpoint` 命令族：由 @zhin.js/adapter 的 createEndpointCommands 套件生成。
- * commands/endpoint/ 下的 list / add / remove 直接默认导出这三项。
+ * `line endpoint` 命令族：由 @zhin.js/adapter 的 createEndpointCommands 套件生成。
+ * commands/line/endpoint/ 下的 list / add / remove 直接默认导出这三项。
  */
 import { createEndpointCommands } from 'zhin.js/adapter';
 import { defineCommand } from 'zhin.js/command';
-import { lineRuntimeStateToken } from './line-runtime-state.js';
+import { lineRuntimeStateToken } from "../../../lib/line-runtime-state.js";
 export const lineEndpointCommands = createEndpointCommands({
     adapterKey: 'line',
     adapterDisplayName: 'LINE',

package/{src/line-endpoint-commands.ts → commands/line/endpoint/definition.ts}

@@ -1,10 +1,10 @@
 /**
- * `line.endpoint` 命令族：由 @zhin.js/adapter 的 createEndpointCommands 套件生成。
- * commands/endpoint/ 下的 list / add / remove 直接默认导出这三项。
+ * `line endpoint` 命令族：由 @zhin.js/adapter 的 createEndpointCommands 套件生成。
+ * commands/line/endpoint/ 下的 list / add / remove 直接默认导出这三项。
  */
 import { createEndpointCommands } from 'zhin.js/adapter';
 import { defineCommand } from 'zhin.js/command';
-import { lineRuntimeStateToken } from './line-runtime-state.js';
+import { lineRuntimeStateToken } from '../../../src/line-runtime-state.js';
 
 export const lineEndpointCommands = createEndpointCommands({
   adapterKey: 'line',

package/commands/{endpoint/list.js → line/endpoint/list/index.js}

@@ -1,3 +1,3 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
-import { lineEndpointCommands } from "../../lib/line-endpoint-commands.js";
+import { lineEndpointCommands } from '../definition.js';
 export default lineEndpointCommands.list;

package/commands/line/endpoint/list/index.ts

@@ -0,0 +1,3 @@
+import { lineEndpointCommands } from '../definition.js';
+
+export default lineEndpointCommands.list;

package/commands/{endpoint/remove/[id].js → line/endpoint/remove/[id]/index.js}

@@ -1,3 +1,3 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
-import { lineEndpointCommands } from "../../../lib/line-endpoint-commands.js";
+import { lineEndpointCommands } from '../../definition.js';
 export default lineEndpointCommands.remove;

package/commands/line/endpoint/remove/[id]/index.ts

@@ -0,0 +1,3 @@
+import { lineEndpointCommands } from '../../definition.js';
+
+export default lineEndpointCommands.remove;

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 { formatInboundContent, formatOutboundMessages, generateMessageId, isMessageEvent, isPostbackEvent, isValidLineRecipientId, normalizeWebhookPath, readTextBody, resolveChannel, resolveLineConfig, verifySignature, type LineEndpointConfig, 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 { LineClient, lineClient, type LineClientEventMap, type LineGroupMember, } from './client.js';

package/lib/line-runtime-state.js

@@ -1,6 +1,6 @@
 /**
  * LINE 插件实例的运行时状态：adapter create() 注册的 endpoint 列表。
- * 由 plugin.ts setup() provide，adapter create 与 `line.endpoint` 命令共享（同一 owner generation）。
+ * 由 plugin.ts setup() provide，adapter create 与 `line endpoint` 命令共享（同一 owner generation）。
  */
 import { defineEndpointRuntimeStateToken } from 'zhin.js/adapter';
 export const lineRuntimeStateToken = defineEndpointRuntimeStateToken('line');

package/lib/protocol.d.ts

@@ -3,18 +3,14 @@
  * Canonicalization is owned by gateway/core before endpoint.send.
  */
 import type { IncomingMessage } from 'node:http';
-import type { ConversationRef } from '@zhin.js/im-contract';
-/** Plugin Runtime owner config (`plugins.<instanceKey>` / schema.json). */
-export interface LineAdapterConfig {
-    readonly id?: string;
-    readonly channelSecret?: string;
-    readonly channelAccessToken?: string;
+import { type ConversationRef } from '@zhin.js/im-contract';
+/** One endpoint config after AdapterIndex expands `plugins.<instanceKey>.endpoints`. */
+export interface LineEndpointConfig {
+    readonly id: 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';
@@ -132,7 +128,7 @@ export interface LineChannel {
     readonly channelType: 'private' | 'group' | 'channel';
     readonly channelId: string;
 }
-export declare function resolveLineConfig(config?: LineAdapterConfig): ResolvedLineConfig;
+export declare function resolveLineConfig(config: LineEndpointConfig): ResolvedLineConfig;
 export declare function normalizeWebhookPath(path: string): string;
 export declare function isMessageEvent(event: LineEvent): event is LineMessageEvent;
 export declare function isLineLifecycleEvent(event: LineEvent): boolean;

package/lib/protocol.js

@@ -3,26 +3,15 @@
  * Canonicalization is owned by gateway/core before endpoint.send.
  */
 import { createHmac, timingSafeEqual } from 'node:crypto';
-import { isMediaRef } from '@zhin.js/core';
+import { isMediaRef } from '@zhin.js/im-contract';
 import { formatCompact, getLogger } from '@zhin.js/logger';
 const logger = getLogger('line');
-export function resolveLineConfig(config = {}) {
-    const entry = config.endpoints?.find((item) => item.context === 'line');
-    const channelSecret = config.channelSecret
-        ?? entry?.channelSecret
-        ?? process.env.LINE_CHANNEL_SECRET;
-    const channelAccessToken = config.channelAccessToken
-        ?? entry?.channelAccessToken
-        ?? process.env.LINE_CHANNEL_ACCESS_TOKEN;
-    if (!channelSecret || !channelAccessToken) {
-        throw new TypeError('LINE adapter requires channelSecret + channelAccessToken (plugins.<key> or endpoints with context: line)');
-    }
-    const id = (typeof config.id === 'string' && config.id)
-        || (typeof entry?.id === 'string' && entry.id)
-        || process.env.LINE_BOT_NAME
-        || 'line-bot';
-    const webhookPath = normalizeWebhookPath(config.webhookPath ?? entry?.webhookPath ?? '/line/webhook');
-    const apiBaseUrl = (config.apiBaseUrl ?? entry?.apiBaseUrl ?? 'https://api.line.me').replace(/\/$/, '');
+export function resolveLineConfig(config) {
+    const id = requiredEndpointField(config.id, 'id');
+    const channelSecret = requiredEndpointField(config.channelSecret, 'channelSecret');
+    const channelAccessToken = requiredEndpointField(config.channelAccessToken, 'channelAccessToken');
+    const webhookPath = normalizeWebhookPath(config.webhookPath ?? '/line/webhook');
+    const apiBaseUrl = (config.apiBaseUrl ?? 'https://api.line.me').replace(/\/$/, '');
     return {
         context: 'line',
         id,
@@ -32,6 +21,12 @@ export function resolveLineConfig(config = {}) {
         apiBaseUrl,
     };
 }
+function requiredEndpointField(value, field) {
+    if (typeof value !== 'string' || !value.trim()) {
+        throw new TypeError(`LINE endpoint requires a non-empty ${field}`);
+    }
+    return value.trim();
+}
 export function normalizeWebhookPath(path) {
     const trimmed = path.trim() || '/line/webhook';
     return trimmed.startsWith('/') ? trimmed : `/${trimmed}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-line",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "Zhin.js LINE Messaging API adapter for Plugin Runtime (HTTP webhook)",
   "type": "module",
   "main": "./lib/index.js",
@@ -32,26 +32,25 @@
     "directory": "plugins/adapters/line"
   },
   "dependencies": {
-    "@zhin.js/adapter": "1.1.12",
-    "@zhin.js/core": "1.1.35",
-    "@zhin.js/feature-kit": "1.1.0",
-    "@zhin.js/host-http": "1.1.0",
-    "@zhin.js/im-contract": "1.1.0",
-    "@zhin.js/logger": "1.1.0"
+    "@zhin.js/adapter": "1.1.14",
+    "@zhin.js/agent-feature": "1.1.1",
+    "@zhin.js/core": "1.1.37",
+    "@zhin.js/feature-kit": "1.1.1",
+    "@zhin.js/host-http": "1.1.1",
+    "@zhin.js/im-contract": "1.1.1",
+    "@zhin.js/logger": "1.1.1",
+    "@zhin.js/skill": "1.1.1",
+    "@zhin.js/tool": "1.1.1"
   },
   "peerDependencies": {
     "zod": "^4.0.0",
-    "@zhin.js/adapter": "^1.1.12",
-    "@zhin.js/agent": "^1.1.23",
-    "@zhin.js/command": "^1.1.0",
-    "@zhin.js/core": "^1.1.35",
-    "@zhin.js/host-http": "^1.1.0",
-    "zhin.js": "^1.1.0"
+    "@zhin.js/adapter": "^1.1.14",
+    "@zhin.js/command": "^1.1.1",
+    "@zhin.js/core": "^1.1.37",
+    "@zhin.js/host-http": "^1.1.1",
+    "zhin.js": "^1.1.2"
   },
   "peerDependenciesMeta": {
-    "@zhin.js/agent": {
-      "optional": true
-    },
     "@zhin.js/command": {
       "optional": true
     },
@@ -67,8 +66,7 @@
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
     "zod": "^4.4.3",
-    "@zhin.js/agent": "1.1.23",
-    "zhin.js": "1.1.0"
+    "zhin.js": "1.1.2"
   },
   "files": [
     "adapters",
@@ -77,9 +75,11 @@
     "schema.json",
     "src",
     "lib",
-    "agent",
+    "tools",
+    "agents",
     "README.md",
-    "CHANGELOG.md"
+    "CHANGELOG.md",
+    "PERMITS.md"
   ],
   "publishConfig": {
     "access": "public",
@@ -102,6 +102,18 @@
       {
         "package": "@zhin.js/command",
         "api": "^1.0.0"
+      },
+      {
+        "package": "@zhin.js/tool",
+        "api": "^1.0.0"
+      },
+      {
+        "package": "@zhin.js/skill",
+        "api": "^1.0.0"
+      },
+      {
+        "package": "@zhin.js/agent-feature",
+        "api": "^1.0.0"
       }
     ],
     "plugins": []

package/plugin.js

@@ -8,7 +8,7 @@ export default definePlugin({
         displayName: 'LINE Messaging API Adapter',
     },
     setup(context) {
-        // 运行中 endpoint 注册表（line.endpoint list 的"运行中"数据源）
+        // 运行中 endpoint 注册表（line endpoint list 的"运行中"数据源）
         context.resources.provide(lineRuntimeStateToken, createEndpointRuntimeState());
     },
 });

package/schema.json

@@ -31,10 +31,11 @@
     },
     "endpoints": {
       "type": "array",
+      "minItems": 1,
       "description": "多账号：一个插件实例挂多个 endpoint。每项与顶层字段同构（id 必填，其余覆盖顶层）",
       "items": {
         "type": "object",
-        "additionalProperties": true,
+        "additionalProperties": false,
         "properties": {
           "master": {
             "type": [
@@ -62,6 +63,15 @@
             "type": "string",
             "description": "LINE channel access token"
           },
+          "webhookPath": {
+            "type": "string"
+          },
+          "apiBaseUrl": {
+            "type": "string"
+          },
+          "commandPrefix": {
+            "type": "string"
+          },
           "id": {
             "type": "string",
             "description": "LINE bot name"

package/src/index.ts

@@ -10,7 +10,7 @@ export {
   resolveChannel,
   resolveLineConfig,
   verifySignature,
-  type LineAdapterConfig,
+  type LineEndpointConfig,
   type LineApiResponse,
   type LineChannel,
   type LineEvent,

package/src/line-runtime-state.ts

@@ -1,6 +1,6 @@
 /**
  * LINE 插件实例的运行时状态：adapter create() 注册的 endpoint 列表。
- * 由 plugin.ts setup() provide，adapter create 与 `line.endpoint` 命令共享（同一 owner generation）。
+ * 由 plugin.ts setup() provide，adapter create 与 `line endpoint` 命令共享（同一 owner generation）。
  */
 import { defineEndpointRuntimeStateToken } from 'zhin.js/adapter';
 

package/src/protocol.ts

@@ -5,23 +5,18 @@
 
 import { createHmac, timingSafeEqual } from 'node:crypto';
 import type { IncomingMessage } from 'node:http';
-import { isMediaRef } from '@zhin.js/core';
-import type { ConversationRef } from '@zhin.js/im-contract';
+import { isMediaRef, type ConversationRef } from '@zhin.js/im-contract';
 import { formatCompact, getLogger } from '@zhin.js/logger';
 
 const logger = getLogger('line');
 
-/** Plugin Runtime owner config (`plugins.<instanceKey>` / schema.json). */
-export interface LineAdapterConfig {
-  readonly id?: string;
-  readonly channelSecret?: string;
-  readonly channelAccessToken?: string;
+/** One endpoint config after AdapterIndex expands `plugins.<instanceKey>.endpoints`. */
+export interface LineEndpointConfig {
+  readonly id: 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 {
@@ -161,27 +156,15 @@ export interface LineChannel {
   readonly channelId: string;
 }
 
-export function resolveLineConfig(config: LineAdapterConfig = {}): ResolvedLineConfig {
-  const entry = config.endpoints?.find((item) => item.context === 'line');
-  const channelSecret = config.channelSecret
-    ?? entry?.channelSecret
-    ?? process.env.LINE_CHANNEL_SECRET;
-  const channelAccessToken = config.channelAccessToken
-    ?? entry?.channelAccessToken
-    ?? process.env.LINE_CHANNEL_ACCESS_TOKEN;
-  if (!channelSecret || !channelAccessToken) {
-    throw new TypeError(
-      'LINE adapter requires channelSecret + channelAccessToken (plugins.<key> or endpoints with context: line)',
-    );
-  }
-  const id = (typeof config.id === 'string' && config.id)
-    || (typeof entry?.id === 'string' && entry.id)
-    || process.env.LINE_BOT_NAME
-    || 'line-bot';
-  const webhookPath = normalizeWebhookPath(
-    config.webhookPath ?? entry?.webhookPath ?? '/line/webhook',
+export function resolveLineConfig(config: LineEndpointConfig): ResolvedLineConfig {
+  const id = requiredEndpointField(config.id, 'id');
+  const channelSecret = requiredEndpointField(config.channelSecret, 'channelSecret');
+  const channelAccessToken = requiredEndpointField(
+    config.channelAccessToken,
+    'channelAccessToken',
   );
-  const apiBaseUrl = (config.apiBaseUrl ?? entry?.apiBaseUrl ?? 'https://api.line.me').replace(/\/$/, '');
+  const webhookPath = normalizeWebhookPath(config.webhookPath ?? '/line/webhook');
+  const apiBaseUrl = (config.apiBaseUrl ?? 'https://api.line.me').replace(/\/$/, '');
   return {
     context: 'line',
     id,
@@ -192,6 +175,16 @@ export function resolveLineConfig(config: LineAdapterConfig = {}): ResolvedLineC
   };
 }
 
+function requiredEndpointField(
+  value: unknown,
+  field: 'id' | 'channelSecret' | 'channelAccessToken',
+): string {
+  if (typeof value !== 'string' || !value.trim()) {
+    throw new TypeError(`LINE endpoint requires a non-empty ${field}`);
+  }
+  return value.trim();
+}
+
 export function normalizeWebhookPath(path: string): string {
   const trimmed = path.trim() || '/line/webhook';
   return trimmed.startsWith('/') ? trimmed : `/${trimmed}`;

package/commands/endpoint/add/[id].ts

@@ -1,3 +0,0 @@
-import { lineEndpointCommands } from '../../../src/line-endpoint-commands.js';
-
-export default lineEndpointCommands.add;

package/commands/endpoint/list.ts

@@ -1,3 +0,0 @@
-import { lineEndpointCommands } from '../../src/line-endpoint-commands.js';
-
-export default lineEndpointCommands.list;

package/commands/endpoint/remove/[id].ts

@@ -1,3 +0,0 @@
-import { lineEndpointCommands } from '../../../src/line-endpoint-commands.js';
-
-export default lineEndpointCommands.remove;

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

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