@zhin.js/adapter-lark 4.0.0 → 4.0.2

package/lib/src/index.js

@@ -0,0 +1,43 @@
+/**
+ * 飞书/Lark 适配器入口：类型扩展、导出、注册
+ */
+import { usePlugin, createSceneManagementTools } from "zhin.js";
+import { LarkAdapter } from "./adapter.js";
+import { larkGroupPermitResolver, registerLarkPlatformPermitChecker, } from "./platform-permit.js";
+import { setLarkAgentDeps } from "./lark-agent-deps.js";
+export * from "./types.js";
+export { LarkEndpoint } from "./endpoint.js";
+export { LarkAdapter } from "./adapter.js";
+const plugin = usePlugin();
+const { provide, useContext } = plugin;
+useContext("router", (router) => {
+    provide({
+        name: "lark",
+        description: "Lark/Feishu Endpoint Adapter",
+        mounted: async (p) => {
+            const adapter = new LarkAdapter(p, router);
+            await adapter.start();
+            return adapter;
+        },
+        dispose: async (adapter) => {
+            await adapter.stop();
+        },
+    });
+});
+useContext('tool', 'lark', (toolService, lark) => {
+    const disposers = [];
+    disposers.push(registerLarkPlatformPermitChecker());
+    setLarkAgentDeps({
+        getEndpoint: (endpointId) => {
+            const endpoint = lark.endpoints.get(endpointId);
+            if (!endpoint)
+                throw new Error(`Endpoint ${endpointId} 不存在`);
+            return endpoint;
+        },
+        getAdapter: () => lark,
+    });
+    const sceneTools = createSceneManagementTools(lark, 'lark', { permitResolver: larkGroupPermitResolver, registerChecker: false });
+    disposers.push(...sceneTools.map(t => toolService.addTool(t, plugin.name)));
+    return () => disposers.forEach(d => d());
+});
+//# sourceMappingURL=index.js.map

package/lib/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,SAAS,EAAoD,0BAA0B,EAAoB,MAAM,SAAS,CAAC;AACpI,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EACL,uBAAuB,EACvB,iCAAiC,GAClC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAaxD,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;AAC3B,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;AAEtC,UAA+D,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE;IACpF,OAAO,CAAC;QACN,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,8BAA8B;QAC3C,OAAO,EAAE,KAAK,EAAE,CAAS,EAAE,EAAE;YAC3B,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;YAC3C,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;YACtB,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,OAAoB,EAAE,EAAE;YACtC,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;QACvB,CAAC;KACiB,CAAC,CAAC;AACxB,CAAC,CAAC,CAAC;AAEH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,WAAwB,EAAE,IAAiB,EAAE,EAAE;IACzE,MAAM,SAAS,GAAmB,EAAE,CAAC;IACrC,SAAS,CAAC,IAAI,CAAC,iCAAiC,EAAE,CAAC,CAAC;IACpD,gBAAgB,CAAC;QACf,WAAW,EAAE,CAAC,UAAU,EAAE,EAAE;YAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YAChD,IAAI,CAAC,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,YAAY,UAAU,MAAM,CAAC,CAAC;YAC7D,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI;KACvB,CAAC,CAAC;IACH,MAAM,UAAU,GAAG,0BAA0B,CAC3C,IAAmC,EACnC,MAAM,EACN,EAAE,cAAc,EAAE,uBAAuB,EAAE,eAAe,EAAE,KAAK,EAAE,CACpE,CAAC;IACF,SAAS,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC5E,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;AAC3C,CAAC,CAAC,CAAC"}

package/lib/src/lark-agent-deps.js

@@ -0,0 +1,10 @@
+let _deps = null;
+export function setLarkAgentDeps(deps) {
+    _deps = deps;
+}
+export function getLarkAgentDeps() {
+    if (!_deps)
+        throw new Error('lark agent deps not initialized');
+    return _deps;
+}
+//# sourceMappingURL=lark-agent-deps.js.map

package/lib/src/lark-agent-deps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lark-agent-deps.js","sourceRoot":"","sources":["../../src/lark-agent-deps.ts"],"names":[],"mappings":"AAQA,IAAI,KAAK,GAAyB,IAAI,CAAC;AAEvC,MAAM,UAAU,gBAAgB,CAAC,IAAmB;IAClD,KAAK,GAAG,IAAI,CAAC;AACf,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IAC/D,OAAO,KAAK,CAAC;AACf,CAAC"}

package/lib/{platform-permit.js → src/platform-permit.js}

@@ -1,11 +1,14 @@
+/**
+ * 飞书 Lark platform permit
+ */
 import { registerPlatformPermitChecker } from 'zhin.js';
 const ADAPTER = 'lark';
 export function platformPermit(perm) {
     return `platform(${ADAPTER},${perm})`;
 }
 const FACTORY_PERM_MAP = {
-    group_admin: 'chat_admin',
-    group_owner: 'chat_owner',
+    scene_admin: 'chat_admin',
+    scene_owner: 'chat_owner',
 };
 export function larkGroupPermitResolver(logicalPerm) {
     return platformPermit(FACTORY_PERM_MAP[logicalPerm] ?? logicalPerm);

package/lib/src/platform-permit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-permit.js","sourceRoot":"","sources":["../../src/platform-permit.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,6BAA6B,EAAgB,MAAM,SAAS,CAAC;AAEtE,MAAM,OAAO,GAAG,MAAM,CAAC;AAEvB,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,YAAY,OAAO,IAAI,IAAI,GAAG,CAAC;AACxC,CAAC;AAED,MAAM,gBAAgB,GAA2B;IAC/C,WAAW,EAAE,YAAY;IACzB,WAAW,EAAE,YAAY;CAC1B,CAAC;AAEF,MAAM,UAAU,uBAAuB,CAAC,WAAmB;IACzD,OAAO,cAAc,CAAC,gBAAgB,CAAC,WAAW,CAAC,IAAI,WAAW,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,KAG5C;IACC,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,YAAY,EAAE,YAAY,EAAE,iBAAiB,CAAC,EAAE,CAAC;IACzF,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC;IACxD,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,IAAY,EAAE,OAAqB;IACzE,MAAM,MAAM,GAAG,OAAO,CAAC,OAAoD,CAAC;IAC5E,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC;IAC7C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IACzB,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAEnD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,YAAY;YACf,OAAO,IAAI,KAAK,OAAO,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC;QAC/C,KAAK,YAAY;YACf,OAAO,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,OAAO,IAAI,GAAG,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC;QACxF,KAAK,iBAAiB;YACpB,OAAO,IAAI,KAAK,OAAO,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC;QAC/C;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iCAAiC;IAC/C,OAAO,6BAA6B,CAAC,OAAO,EAAE,uBAAuB,CAAC,CAAC;AACzE,CAAC"}

package/lib/src/segment-mapper.js

@@ -0,0 +1,2 @@
+export { toCanonicalSegments, fromCanonicalSegments } from 'zhin.js';
+//# sourceMappingURL=segment-mapper.js.map

package/lib/src/segment-mapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"segment-mapper.js","sourceRoot":"","sources":["../../src/segment-mapper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC"}

package/lib/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-lark",
-  "version": "4.0.0",
+  "version": "4.0.2",
   "description": "Zhin.js adapter for Lark/Feishu (飞书)",
   "type": "module",
   "main": "./lib/index.js",
@@ -38,26 +38,36 @@
   },
   "devDependencies": {
     "@types/koa": "^3.0.3",
-    "@types/node": "^25.9.2",
+    "@types/node": "^26.1.0",
     "typescript": "^6.0.3",
-    "@zhin.js/host-router": "2.0.1",
-    "zhin.js": "4.1.0"
+    "zod": "^4.4.3",
+    "@zhin.js/host-router": "2.0.3",
+    "zhin.js": "4.1.2",
+    "@zhin.js/agent": "1.0.3"
   },
   "peerDependencies": {
-    "zhin.js": "4.1.0",
-    "@zhin.js/host-router": "2.0.1"
+    "zod": "^4.0.0",
+    "@zhin.js/agent": "1.0.3",
+    "@zhin.js/host-router": "2.0.3",
+    "zhin.js": "4.1.2"
   },
   "peerDependenciesMeta": {
+    "@zhin.js/agent": {
+      "optional": true
+    },
     "@zhin.js/host-router": {
       "optional": false
+    },
+    "zod": {
+      "optional": true
     }
   },
   "files": [
     "src",
     "lib",
+    "agent",
     "client",
     "dist",
-    "skills",
     "plugin.yml",
     "README.md",
     "node",

package/src/adapter.ts

@@ -9,6 +9,7 @@ import type { LarkEndpointConfig } from "./types.js";
 export class LarkAdapter extends Adapter<LarkEndpoint> {
   static override readonly capabilities = ['inbound', 'outbound'] as const;
   static override outboundRichSegmentPolicy = OUTBOUND_RICH_SEGMENT_POLICY_IM_FULL;
+  static override interactivePolicy = 'native' as const;
 
     #router: any;
 
@@ -21,9 +22,9 @@ export class LarkAdapter extends Adapter<LarkEndpoint> {
         return new LarkEndpoint(this, this.#router, config);
     }
 
-    // ── IGroupManagement 标准群管方法 ──────────────────────────────────
+    // ── ISceneManagement 标准群管方法 ──────────────────────────────────
 
-    async kickMember(endpointId: string, sceneId: string, userId: string) {
+    async removeMember(endpointId: string, sceneId: string, userId: string) {
         const endpoint = this.endpoints.get(endpointId);
         if (!endpoint) throw new Error(`Endpoint ${endpointId} 不存在`);
         return endpoint.removeChatMembers(sceneId, [userId]);
@@ -35,13 +36,13 @@ export class LarkAdapter extends Adapter<LarkEndpoint> {
         return endpoint.getChatMembers(sceneId);
     }
 
-    async getGroupInfo(endpointId: string, sceneId: string) {
+    async getSceneInfo(endpointId: string, sceneId: string) {
         const endpoint = this.endpoints.get(endpointId);
         if (!endpoint) throw new Error(`Endpoint ${endpointId} 不存在`);
         return endpoint.getChatInfo(sceneId);
     }
 
-    async setGroupName(endpointId: string, sceneId: string, name: string) {
+    async renameScene(endpointId: string, sceneId: string, name: string) {
         const endpoint = this.endpoints.get(endpointId);
         if (!endpoint) throw new Error(`Endpoint ${endpointId} 不存在`);
         return endpoint.updateChatInfo(sceneId, { name });

package/src/endpoint.ts

@@ -4,10 +4,11 @@
 import { registerFetchRoute, type Router, type RouterContext } from "@zhin.js/host-router/router";
 import axios, { type AxiosInstance } from "axios";
 import { createHash } from "crypto";
-import { formatCompact, Endpoint, Message, MessageSegment, segment, SendContent, SendOptions,} from 'zhin.js';
+import { formatCompact, Endpoint, Message, MessageSegment, segment, SendContent, SendOptions, expandInteractiveSegmentsInContent,} from 'zhin.js';
 import type { LarkEndpointConfig, LarkMessage, LarkEvent, AccessToken } from "./types.js";
 import type { LarkAdapter } from "./adapter.js";
 import { normalizeLarkSenderForPermit } from "./platform-permit.js";
+import { fromCanonicalSegments, toCanonicalSegments } from './segment-mapper.js';
 
 export class LarkEndpoint implements Endpoint<LarkEndpointConfig, LarkMessage> {
     $connected: boolean
@@ -221,7 +222,8 @@ export class LarkEndpoint implements Endpoint<LarkEndpointConfig, LarkMessage> {
     // ================================================================================================
 
     $formatMessage(msg: LarkMessage, event?: any): Message<LarkMessage> {
-        const content = this.parseMessageContent(msg);
+        const wire = this.parseMessageContent(msg);
+        const content = toCanonicalSegments(wire);
         
         // 确定聊天类型
         const chatType = msg.chat_id?.startsWith('oc_') ? 'group' : 'private';
@@ -373,7 +375,9 @@ export class LarkEndpoint implements Endpoint<LarkEndpointConfig, LarkMessage> {
 
     async $sendMessage(options: SendOptions): Promise<string> {
         const chatId = options.id;
-        const content = this.formatSendContent(options.content);
+        const canonical = expandInteractiveSegmentsInContent(options.content);
+        const wire = fromCanonicalSegments(canonical);
+        const content = this.formatSendContent(wire);
         
         try {
             const response = await this.axiosInstance.post('/im/v1/messages', {
@@ -492,8 +496,8 @@ export class LarkEndpoint implements Endpoint<LarkEndpointConfig, LarkMessage> {
             await this.refreshAccessToken();
             
             this.$connected = true;
-            this.logger.info(formatCompact({ endpoint: this.$config.name }));
-            this.logger.info(formatCompact( { op: 'webhook', path: this.$config.webhookPath }));
+            this.logger.debug(formatCompact({ endpoint: this.$config.name }));
+            this.logger.debug(formatCompact( { op: 'webhook', path: this.$config.webhookPath }));
             
         } catch (error) {
             this.logger.error('Failed to connect Lark bot:', error);
@@ -504,7 +508,7 @@ export class LarkEndpoint implements Endpoint<LarkEndpointConfig, LarkMessage> {
     async $disconnect(): Promise<void> {
         try {
             this.$connected = false;
-            this.logger.info(formatCompact( { op: 'disconnect', endpoint: this.$config.name }));
+            this.logger.debug(formatCompact( { op: 'disconnect', endpoint: this.$config.name }));
         } catch (error) {
             this.logger.error('Error disconnecting Lark bot:', error);
         }

package/src/index.ts

@@ -1,13 +1,13 @@
 /**
  * 飞书/Lark 适配器入口：类型扩展、导出、注册
  */
-import { usePlugin, type Plugin, type Context, type IGroupManagement, createGroupManagementTools, type ToolFeature } from "zhin.js";
+import { usePlugin, type Plugin, type Context, type ISceneManagement, createSceneManagementTools, type ToolFeature } from "zhin.js";
 import { LarkAdapter } from "./adapter.js";
 import {
   larkGroupPermitResolver,
-  platformPermit,
   registerLarkPlatformPermitChecker,
 } from "./platform-permit.js";
+import { setLarkAgentDeps } from "./lark-agent-deps.js";
 
 declare module "zhin.js" {
   namespace Plugin {
@@ -45,195 +45,19 @@ const { provide, useContext } = plugin;
 useContext('tool', 'lark', (toolService: ToolFeature, lark: LarkAdapter) => {
   const disposers: (() => void)[] = [];
   disposers.push(registerLarkPlatformPermitChecker());
-  const groupTools = createGroupManagementTools(
-    lark as unknown as IGroupManagement,
+  setLarkAgentDeps({
+    getEndpoint: (endpointId) => {
+      const endpoint = lark.endpoints.get(endpointId);
+      if (!endpoint) throw new Error(`Endpoint ${endpointId} 不存在`);
+      return endpoint;
+    },
+    getAdapter: () => lark,
+  });
+  const sceneTools = createSceneManagementTools(
+    lark as unknown as ISceneManagement,
     'lark',
     { permitResolver: larkGroupPermitResolver, registerChecker: false },
   );
-  disposers.push(...groupTools.map(t => toolService.addTool(t, plugin.name)));
-
-  disposers.push(toolService.addTool({
-    name: 'lark_get_user',
-    description: '获取飞书用户信息',
-    parameters: {
-      type: 'object',
-      properties: {
-        endpoint_id: { type: 'string', description: 'Endpoint 名称', contextKey: 'endpointId' },
-        user_id: { type: 'string', description: '用户 ID (open_id)' },
-      },
-      required: ['endpoint_id', 'user_id'],
-    },
-    platforms: ['lark'],
-    tags: ['lark'],
-    execute: async (args: Record<string, any>) => {
-      const endpoint = lark.endpoints.get(args.endpoint_id);
-      if (!endpoint) throw new Error(`Endpoint ${args.endpoint_id} 不存在`);
-      return await endpoint.getUserInfo(args.user_id);
-    },
-  }, plugin.name));
-
-  disposers.push(toolService.addTool({
-    name: 'lark_create_chat',
-    description: '创建飞书群聊',
-    parameters: {
-      type: 'object',
-      properties: {
-        endpoint_id: { type: 'string', description: 'Endpoint 名称', contextKey: 'endpointId' },
-        name: { type: 'string', description: '群名' },
-        members: { type: 'string', description: '成员 open_id 列表，逗号分隔' },
-        owner: { type: 'string', description: '群主 open_id（可选）' },
-      },
-      required: ['endpoint_id', 'name', 'members'],
-    },
-    platforms: ['lark'],
-    tags: ['lark'],
-    execute: async (args: Record<string, any>) => {
-      const endpoint = lark.endpoints.get(args.endpoint_id);
-      if (!endpoint) throw new Error(`Endpoint ${args.endpoint_id} 不存在`);
-      const chatId = await endpoint.createChat(args.name, args.members.split(','), args.owner);
-      return { success: !!chatId, chat_id: chatId, message: chatId ? `群聊创建成功: ${chatId}` : '创建失败' };
-    },
-  }, plugin.name));
-
-  disposers.push(toolService.addTool({
-    name: 'lark_update_chat',
-    description: '更新飞书群聊信息（群名、描述）',
-    parameters: {
-      type: 'object',
-      properties: {
-        endpoint_id: { type: 'string', description: 'Endpoint 名称', contextKey: 'endpointId' },
-        chat_id: { type: 'string', description: '群聊 ID' },
-        name: { type: 'string', description: '新群名（可选）' },
-        description: { type: 'string', description: '新描述（可选）' },
-      },
-      required: ['endpoint_id', 'chat_id'],
-    },
-    platforms: ['lark'],
-    tags: ['lark'],
-    permissions: [platformPermit('chat_admin')],
-    execute: async (args: Record<string, any>) => {
-      const endpoint = lark.endpoints.get(args.endpoint_id);
-      if (!endpoint) throw new Error(`Endpoint ${args.endpoint_id} 不存在`);
-      const success = await endpoint.updateChatInfo(args.chat_id, { name: args.name, description: args.description });
-      return { success, message: success ? '群信息更新成功' : '更新失败' };
-    },
-  }, plugin.name));
-
-  disposers.push(toolService.addTool({
-    name: 'lark_add_members',
-    description: '添加飞书群成员',
-    parameters: {
-      type: 'object',
-      properties: {
-        endpoint_id: { type: 'string', description: 'Endpoint 名称', contextKey: 'endpointId' },
-        chat_id: { type: 'string', description: '群聊 ID' },
-        user_ids: { type: 'string', description: '用户 open_id 列表，逗号分隔' },
-      },
-      required: ['endpoint_id', 'chat_id', 'user_ids'],
-    },
-    platforms: ['lark'],
-    tags: ['lark'],
-    permissions: [platformPermit('chat_admin')],
-    execute: async (args: Record<string, any>) => {
-      const endpoint = lark.endpoints.get(args.endpoint_id);
-      if (!endpoint) throw new Error(`Endpoint ${args.endpoint_id} 不存在`);
-      const success = await endpoint.addChatMembers(args.chat_id, args.user_ids.split(','));
-      return { success, message: success ? '成员添加成功' : '添加失败' };
-    },
-  }, plugin.name));
-
-  disposers.push(toolService.addTool({
-    name: 'lark_set_managers',
-    description: '设置飞书群管理员',
-    parameters: {
-      type: 'object',
-      properties: {
-        endpoint_id: { type: 'string', description: 'Endpoint 名称', contextKey: 'endpointId' },
-        chat_id: { type: 'string', description: '群聊 ID' },
-        user_ids: { type: 'string', description: '用户 open_id 列表，逗号分隔' },
-      },
-      required: ['endpoint_id', 'chat_id', 'user_ids'],
-    },
-    platforms: ['lark'],
-    tags: ['lark'],
-    permissions: [platformPermit('manage_managers')],
-    execute: async (args: Record<string, any>) => {
-      const endpoint = lark.endpoints.get(args.endpoint_id);
-      if (!endpoint) throw new Error(`Endpoint ${args.endpoint_id} 不存在`);
-      const success = await endpoint.setChatManagers(args.chat_id, args.user_ids.split(','));
-      return { success, message: success ? '管理员设置成功' : '设置失败' };
-    },
-  }, plugin.name));
-
-  disposers.push(toolService.addTool({
-    name: 'lark_remove_managers',
-    description: '移除飞书群管理员',
-    parameters: {
-      type: 'object',
-      properties: {
-        endpoint_id: { type: 'string', description: 'Endpoint 名称', contextKey: 'endpointId' },
-        chat_id: { type: 'string', description: '群聊 ID' },
-        user_ids: { type: 'string', description: '用户 open_id 列表，逗号分隔' },
-      },
-      required: ['endpoint_id', 'chat_id', 'user_ids'],
-    },
-    platforms: ['lark'],
-    tags: ['lark'],
-    permissions: [platformPermit('manage_managers')],
-    execute: async (args: Record<string, any>) => {
-      const endpoint = lark.endpoints.get(args.endpoint_id);
-      if (!endpoint) throw new Error(`Endpoint ${args.endpoint_id} 不存在`);
-      const success = await endpoint.removeChatManagers(args.chat_id, args.user_ids.split(','));
-      return { success, message: success ? '管理员移除成功' : '移除失败' };
-    },
-  }, plugin.name));
-
-  disposers.push(toolService.addTool({
-    name: 'lark_dissolve_chat',
-    description: '解散飞书群聊（需要群主权限）',
-    parameters: {
-      type: 'object',
-      properties: {
-        endpoint_id: { type: 'string', description: 'Endpoint 名称', contextKey: 'endpointId' },
-        chat_id: { type: 'string', description: '群聊 ID' },
-      },
-      required: ['endpoint_id', 'chat_id'],
-    },
-    platforms: ['lark'],
-    tags: ['lark'],
-    execute: async (args: Record<string, any>) => {
-      const endpoint = lark.endpoints.get(args.endpoint_id);
-      if (!endpoint) throw new Error(`Endpoint ${args.endpoint_id} 不存在`);
-      const success = await endpoint.dissolveChat(args.chat_id);
-      return { success, message: success ? '群聊已解散' : '解散失败' };
-    },
-  }, plugin.name));
-
-  disposers.push(toolService.addTool({
-    name: 'lark_upload_file',
-    description: '上传文件到飞书（opus/mp4/pdf/doc/xls/ppt/stream）',
-    parameters: {
-      type: 'object',
-      properties: {
-        endpoint_id: { type: 'string', description: 'Endpoint 名称', contextKey: 'endpointId' },
-        file_path: { type: 'string', description: '本地文件路径' },
-        file_type: { type: 'string', description: '文件类型', enum: ['opus', 'mp4', 'pdf', 'doc', 'xls', 'ppt', 'stream'] },
-      },
-      required: ['endpoint_id', 'file_path', 'file_type'],
-    },
-    platforms: ['lark'],
-    tags: ['lark'],
-    execute: async (args: Record<string, any>) => {
-      const validTypes = ['opus', 'mp4', 'pdf', 'doc', 'xls', 'ppt', 'stream'];
-      if (!validTypes.includes(args.file_type)) {
-        throw new Error(`不支持的文件类型: ${args.file_type}，支持: ${validTypes.join(', ')}`);
-      }
-      const endpoint = lark.endpoints.get(args.endpoint_id);
-      if (!endpoint) throw new Error(`Endpoint ${args.endpoint_id} 不存在`);
-      const result = await endpoint.uploadFile(args.file_path, args.file_type);
-      return { success: true, file_key: result, message: `文件已上传，file_key: ${result}` };
-    },
-  }, plugin.name));
-
+  disposers.push(...sceneTools.map(t => toolService.addTool(t, plugin.name)));
   return () => disposers.forEach(d => d());
 });

package/src/lark-agent-deps.ts

@@ -0,0 +1,18 @@
+import type { LarkAdapter } from './adapter.js';
+import type { LarkEndpoint } from './endpoint.js';
+
+export interface LarkAgentDeps {
+  getEndpoint: (endpointId: string) => LarkEndpoint;
+  getAdapter: () => LarkAdapter;
+}
+
+let _deps: LarkAgentDeps | null = null;
+
+export function setLarkAgentDeps(deps: LarkAgentDeps): void {
+  _deps = deps;
+}
+
+export function getLarkAgentDeps(): LarkAgentDeps {
+  if (!_deps) throw new Error('lark agent deps not initialized');
+  return _deps;
+}

package/src/platform-permit.ts

@@ -1,8 +1,7 @@
 /**
  * 飞书 Lark platform permit
  */
-import type { Message } from 'zhin.js';
-import { registerPlatformPermitChecker } from 'zhin.js';
+import { registerPlatformPermitChecker, type Message } from 'zhin.js';
 
 const ADAPTER = 'lark';
 
@@ -11,8 +10,8 @@ export function platformPermit(perm: string): string {
 }
 
 const FACTORY_PERM_MAP: Record<string, string> = {
-  group_admin: 'chat_admin',
-  group_owner: 'chat_owner',
+  scene_admin: 'chat_admin',
+  scene_owner: 'chat_owner',
 };
 
 export function larkGroupPermitResolver(logicalPerm: string): string {

package/src/segment-mapper.ts

@@ -0,0 +1 @@
+export { toCanonicalSegments, fromCanonicalSegments } from 'zhin.js';

package/lib/adapter.d.ts

@@ -1,19 +0,0 @@
-/**
- * 飞书/Lark 适配器
- */
-import { Adapter, Plugin } from 'zhin.js';
-import { LarkEndpoint } from "./endpoint.js";
-import type { LarkEndpointConfig } from "./types.js";
-export declare class LarkAdapter extends Adapter<LarkEndpoint> {
-    #private;
-    static readonly capabilities: readonly ["inbound", "outbound"];
-    static outboundRichSegmentPolicy: import("zhin.js").OutboundRichSegmentPolicy;
-    constructor(plugin: Plugin, router: any);
-    createEndpoint(config: LarkEndpointConfig): LarkEndpoint;
-    kickMember(endpointId: string, sceneId: string, userId: string): Promise<boolean>;
-    listMembers(endpointId: string, sceneId: string): Promise<any[]>;
-    getGroupInfo(endpointId: string, sceneId: string): Promise<any>;
-    setGroupName(endpointId: string, sceneId: string, name: string): Promise<boolean>;
-    start(): Promise<void>;
-}
-//# sourceMappingURL=adapter.d.ts.map

package/lib/adapter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,OAAO,EACd,MAAM,EAAwC,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,qBAAa,WAAY,SAAQ,OAAO,CAAC,YAAY,CAAC;;IACpD,gBAAyB,YAAY,mCAAoC;IACzE,OAAgB,yBAAyB,8CAAwC;gBAInE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG;IAKvC,cAAc,CAAC,MAAM,EAAE,kBAAkB,GAAG,YAAY;IAMlD,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAM9D,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAM/C,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAMhD,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAQ9D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAI/B"}

package/lib/adapter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,OAAO,EACN,oCAAoC,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAG7C,MAAM,OAAO,WAAY,SAAQ,OAAqB;IACpD,MAAM,CAAmB,YAAY,GAAG,CAAC,SAAS,EAAE,UAAU,CAAU,CAAC;IACzE,MAAM,CAAU,yBAAyB,GAAG,oCAAoC,CAAC;IAE/E,OAAO,CAAM;IAEb,YAAY,MAAc,EAAE,MAAW;QACnC,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;QAC1B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IAC1B,CAAC;IAED,cAAc,CAAC,MAA0B;QACrC,OAAO,IAAI,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACxD,CAAC;IAED,gEAAgE;IAEhE,KAAK,CAAC,UAAU,CAAC,UAAkB,EAAE,OAAe,EAAE,MAAc;QAChE,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAChD,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,YAAY,UAAU,MAAM,CAAC,CAAC;QAC7D,OAAO,QAAQ,CAAC,iBAAiB,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,UAAkB,EAAE,OAAe;QACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAChD,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,YAAY,UAAU,MAAM,CAAC,CAAC;QAC7D,OAAO,QAAQ,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,UAAkB,EAAE,OAAe;QAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAChD,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,YAAY,UAAU,MAAM,CAAC,CAAC;QAC7D,OAAO,QAAQ,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,UAAkB,EAAE,OAAe,EAAE,IAAY;QAChE,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAChD,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,YAAY,UAAU,MAAM,CAAC,CAAC;QAC7D,OAAO,QAAQ,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,kEAAkE;IAElE,KAAK,CAAC,KAAK;QACP,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC"}

package/lib/endpoint.d.ts

@@ -1,84 +0,0 @@
-import { Endpoint, Message, SendOptions } from 'zhin.js';
-import type { LarkEndpointConfig, LarkMessage } from "./types.js";
-import type { LarkAdapter } from "./adapter.js";
-export declare class LarkEndpoint implements Endpoint<LarkEndpointConfig, LarkMessage> {
-    adapter: LarkAdapter;
-    $config: LarkEndpointConfig;
-    $connected: boolean;
-    private router;
-    private accessToken;
-    private axiosInstance;
-    get logger(): import("zhin.js").Logger;
-    get $id(): string;
-    constructor(adapter: LarkAdapter, router: any, $config: LarkEndpointConfig);
-    private setupWebhookRoute;
-    private handleWebhook;
-    private verifySignature;
-    private chatPermitCache;
-    private enrichGroupSender;
-    private handleEvent;
-    private ensureAccessToken;
-    private refreshAccessToken;
-    $formatMessage(msg: LarkMessage, event?: any): Message<LarkMessage>;
-    private parseMessageContent;
-    private parseRichTextContent;
-    $sendMessage(options: SendOptions): Promise<string>;
-    $recallMessage(id: string): Promise<void>;
-    private formatSendContent;
-    $connect(): Promise<void>;
-    $disconnect(): Promise<void>;
-    getUserInfo(userId: string, userIdType?: 'open_id' | 'user_id' | 'union_id'): Promise<any>;
-    getChatInfo(chatId: string): Promise<any>;
-    uploadFile(filePath: string, fileType?: 'image' | 'file' | 'video' | 'audio'): Promise<string | null>;
-    /**
-     * 创建群聊
-     * @param name 群名
-     * @param userIds 成员 open_id 列表
-     * @param ownerId 群主 open_id
-     */
-    createChat(name: string, userIds: string[], ownerId?: string): Promise<string | null>;
-    /**
-     * 更新群信息
-     * @param chatId 群聊 ID
-     * @param options 更新选项
-     */
-    updateChatInfo(chatId: string, options: {
-        name?: string;
-        description?: string;
-    }): Promise<boolean>;
-    /**
-     * 添加群成员
-     * @param chatId 群聊 ID
-     * @param userIds 用户 ID 列表
-     */
-    addChatMembers(chatId: string, userIds: string[]): Promise<boolean>;
-    /**
-     * 移除群成员
-     * @param chatId 群聊 ID
-     * @param userIds 用户 ID 列表
-     */
-    removeChatMembers(chatId: string, userIds: string[]): Promise<boolean>;
-    /**
-     * 获取群成员列表
-     * @param chatId 群聊 ID
-     */
-    getChatMembers(chatId: string): Promise<any[]>;
-    /**
-     * 解散群聊
-     * @param chatId 群聊 ID
-     */
-    dissolveChat(chatId: string): Promise<boolean>;
-    /**
-     * 设置群管理员
-     * @param chatId 群聊 ID
-     * @param userIds 用户 ID 列表
-     */
-    setChatManagers(chatId: string, userIds: string[]): Promise<boolean>;
-    /**
-     * 移除群管理员
-     * @param chatId 群聊 ID
-     * @param userIds 用户 ID 列表
-     */
-    removeChatManagers(chatId: string, userIds: string[]): Promise<boolean>;
-}
-//# sourceMappingURL=endpoint.d.ts.map

package/lib/endpoint.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"endpoint.d.ts","sourceRoot":"","sources":["../src/endpoint.ts"],"names":[],"mappings":"AAMA,OAAO,EAAiB,QAAQ,EAAE,OAAO,EAAwC,WAAW,EAAE,MAAM,SAAS,CAAC;AAC9G,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAA0B,MAAM,YAAY,CAAC;AAC1F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,qBAAa,YAAa,YAAW,QAAQ,CAAC,kBAAkB,EAAE,WAAW,CAAC;IAcvD,OAAO,EAAE,WAAW;IAAsB,OAAO,EAAE,kBAAkB;IAbxF,UAAU,EAAE,OAAO,CAAA;IACnB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,aAAa,CAAe;IAEpC,IAAI,MAAM,6BAEX;IAED,IAAI,GAAG,WAEJ;gBAEkB,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,EAAS,OAAO,EAAE,kBAAkB;IA+BxF,OAAO,CAAC,iBAAiB;YAMX,aAAa;IAqD3B,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,eAAe,CAA2E;YAEpF,iBAAiB;YA6BjB,WAAW;YAoBX,iBAAiB;YAUjB,kBAAkB;IAiChC,cAAc,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC;IAoCnE,OAAO,CAAC,mBAAmB;IA0F3B,OAAO,CAAC,oBAAoB;IAyBtB,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAuBnD,cAAc,CAAC,EAAE,EAAC,MAAM,GAAE,OAAO,CAAC,IAAI,CAAC;IAM7C,OAAO,CAAC,iBAAiB;IAsFnB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAezB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAc5B,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,GAAE,SAAS,GAAG,SAAS,GAAG,UAAsB,GAAG,OAAO,CAAC,GAAG,CAAC;IAcrG,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAWzC,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAE,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,OAAgB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IA4BnH;;;;;OAKG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAmB3F;;;;OAIG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE;QAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;KACxB,GAAG,OAAO,CAAC,OAAO,CAAC;IAepB;;;;OAIG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAiBzE;;;;OAIG;IACG,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAiB5E;;;OAGG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAcpD;;;OAGG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAepD;;;;OAIG;IACG,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAiB1E;;;;OAIG;IACG,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;CAgBhF"}