@zhin.js/agent 0.1.24 → 0.1.26

package/lib/builtin/web-fetch-tool.js

@@ -1,4 +1,6 @@
+import { htmlToPlainText } from '@zhin.js/core';
 import { errMsg } from '../discovery/utils.js';
+import { checkDangerousToolAccess, toDenyError, toOwnerSignal } from '../security/dangerous-tool-policy.js';
 import { BuiltinBaseTool } from './builtin-base-tool.js';
 import { WEB_TOOL_FETCH_TIMEOUT_MS, ZHIN_WEB_USER_AGENT } from './web-tool-utils.js';
 export const WEB_FETCH_DEFAULT_MAX_LENGTH = 20 * 1024;
@@ -10,24 +12,9 @@ export const WEB_FETCH_PARAMETERS = {
     },
     required: ['url'],
 };
-/** 与原先 builtin-tools 中 web_fetch 一致的正文提取链 */
+/** 与原先 builtin-tools 中 web_fetch 一致的正文提取（实现见 @zhin.js/core htmlToPlainText） */
 export function stripFetchedHtmlToText(html) {
-    return html
-        .replace(/<script[^>]*>[\s\S]*?<\/script>/gi, '')
-        .replace(/<style[^>]*>[\s\S]*?<\/style>/gi, '')
-        .replace(/<nav[^>]*>[\s\S]*?<\/nav>/gi, '')
-        .replace(/<footer[^>]*>[\s\S]*?<\/footer>/gi, '')
-        .replace(/<header[^>]*>[\s\S]*?<\/header>/gi, ' ')
-        .replace(/<form[^>]*>[\s\S]*?<\/form>/gi, '')
-        .replace(/<!--[\s\S]*?-->/g, '')
-        .replace(/<[^>]+>/g, ' ')
-        .replace(/&nbsp;/gi, ' ')
-        .replace(/&amp;/g, '&')
-        .replace(/&lt;/g, '<')
-        .replace(/&gt;/g, '>')
-        .replace(/&quot;/g, '"')
-        .replace(/\s+/g, ' ')
-        .trim();
+    return htmlToPlainText(html);
 }
 function isBlockedSsrfHostname(hostname) {
     const h = hostname.toLowerCase();
@@ -50,8 +37,15 @@ export class WebFetchBuiltinTool extends BuiltinBaseTool {
         this.tags.push('web', 'fetch');
         this.keywords.push('抓取网页', '打开链接', '获取网页', '读网页', 'fetch', 'url', '链接内容', '网页内容');
     }
-    async run(args, _context) {
+    async run(args, context) {
         try {
+            const accessDecision = checkDangerousToolAccess('web_fetch', context);
+            if (!accessDecision.allowed) {
+                if (accessDecision.needsOwnerApproval) {
+                    return toOwnerSignal(accessDecision);
+                }
+                return toDenyError(accessDecision);
+            }
             let parsedUrl;
             try {
                 parsedUrl = new URL(String(args.url ?? ''));

package/lib/builtin/web-fetch-tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"web-fetch-tool.js","sourceRoot":"","sources":["../../src/builtin/web-fetch-tool.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"web-fetch-tool.js","sourceRoot":"","sources":["../../src/builtin/web-fetch-tool.ts"],"names":[],"mappings":"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"}

package/lib/builtin/write-file-tool.d.ts

@@ -7,7 +7,7 @@ export declare class WriteFileBuiltinTool extends BuiltinBaseTool {
     readonly parameters: ToolParametersSchema<Record<string, any>>;
     readonly kind = "file";
     constructor();
-    run(args: Record<string, unknown>, _context?: ToolContext): Promise<ToolResult>;
+    run(args: Record<string, unknown>, context?: ToolContext): Promise<ToolResult>;
 }
 export declare function createWriteFileTool(): Tool;
 //# sourceMappingURL=write-file-tool.d.ts.map

package/lib/builtin/write-file-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"write-file-tool.d.ts","sourceRoot":"","sources":["../../src/builtin/write-file-tool.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGzF,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,eAAO,MAAM,qBAAqB,EAAE,oBAOnC,CAAC;AAEF,qBAAa,oBAAqB,SAAQ,eAAe;IACvD,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,QAAQ,CAAC,WAAW,0LACe;IACnC,QAAQ,CAAC,UAAU,4CAAyB;IAC5C,QAAQ,CAAC,IAAI,UAAU;;IAiBjB,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CAyBtF;AAED,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C"}
+{"version":3,"file":"write-file-tool.d.ts","sourceRoot":"","sources":["../../src/builtin/write-file-tool.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAKzF,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,eAAO,MAAM,qBAAqB,EAAE,oBAOnC,CAAC;AAEF,qBAAa,oBAAqB,SAAQ,eAAe;IACvD,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,QAAQ,CAAC,WAAW,0LACe;IACnC,QAAQ,CAAC,UAAU,4CAAyB;IAC5C,QAAQ,CAAC,IAAI,UAAU;;IAiBjB,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CAuDrF;AAED,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C"}

package/lib/builtin/write-file-tool.js

@@ -4,6 +4,8 @@
 import * as fs from 'node:fs/promises';
 import * as path from 'node:path';
 import { checkFileAccess, isBlockedDevicePath } from '../security/file-policy.js';
+import { checkFilePermission, formatFilePermissionMessage, toolRequesterRoleToFileRole } from '../security/file-role-policy.js';
+import { checkFileToolAccess, checkSensitiveFilePathAccess, checkDangerousToolAccess, toDenyError, toOwnerSignal } from '../security/dangerous-tool-policy.js';
 import { expandHome, nodeErrToFileMessage } from '../discovery/utils.js';
 import { BuiltinBaseTool } from './builtin-base-tool.js';
 export const WRITE_FILE_PARAMETERS = {
@@ -24,7 +26,7 @@ export class WriteFileBuiltinTool extends BuiltinBaseTool {
         this.tags.push('file', 'write');
         this.keywords.push('写文件', '写入文件', '创建文件', '保存文件', 'write file', 'write', '保存', '创建');
     }
-    async run(args, _context) {
+    async run(args, context) {
         const filePathArg = args.file_path;
         const contentArg = args.content;
         if (typeof filePathArg !== 'string' || !filePathArg.trim()) {
@@ -33,8 +35,38 @@ export class WriteFileBuiltinTool extends BuiltinBaseTool {
         if (typeof contentArg !== 'string') {
             return 'Error: content is required';
         }
+        // 第 1 层：角色门控（dangerous-tool-policy 从 bot 配置动态获取角色）
+        const roleDecision = checkFileToolAccess('write_file', context);
+        if (!roleDecision.allowed) {
+            if (roleDecision.needsOwnerApproval)
+                return toOwnerSignal(roleDecision);
+            return toDenyError(roleDecision);
+        }
+        // 第 1.5 层：危险工具审批（admin 调用 write_file 需 execAllowlist 或 Owner 确认）
+        const dangerousDecision = checkDangerousToolAccess('write_file', context);
+        if (!dangerousDecision.allowed) {
+            if (dangerousDecision.needsOwnerApproval)
+                return toOwnerSignal(dangerousDecision);
+            return toDenyError(dangerousDecision);
+        }
+        // 第 2 层：文件角色权限矩阵（file-role-policy）
+        const fileRole = context?.fileRole ?? toolRequesterRoleToFileRole(roleDecision.role);
+        const permResult = checkFilePermission(fileRole, 'create', filePathArg);
+        if (!permResult.allowed) {
+            return formatFilePermissionMessage(permResult, 'write_file');
+        }
+        const confirmMsg = formatFilePermissionMessage(permResult, 'write_file');
+        if (confirmMsg)
+            return confirmMsg;
+        // 第 3 层：敏感路径检测（dangerous-tool-policy + file-policy）
         try {
             const fp = expandHome(filePathArg);
+            const sensitiveDecision = checkSensitiveFilePathAccess('write_file', fp, context);
+            if (!sensitiveDecision.allowed) {
+                if (sensitiveDecision.needsOwnerApproval)
+                    return toOwnerSignal(sensitiveDecision);
+                return toDenyError(sensitiveDecision);
+            }
             if (isBlockedDevicePath(fp)) {
                 return `Error: 禁止访问设备路径: ${fp}`;
             }

package/lib/builtin/write-file-tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"write-file-tool.js","sourceRoot":"","sources":["../../src/builtin/write-file-tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAClF,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,MAAM,CAAC,MAAM,qBAAqB,GAAyB;IACzD,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE;QACtD,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE;KACrD;IACD,QAAQ,EAAE,CAAC,WAAW,EAAE,SAAS,CAAC;CACnC,CAAC;AAEF,MAAM,OAAO,oBAAqB,SAAQ,eAAe;IAC9C,IAAI,GAAG,YAAY,CAAC;IACpB,WAAW,GAClB,gCAAgC,CAAC;IAC1B,UAAU,GAAG,qBAAqB,CAAC;IACnC,IAAI,GAAG,MAAM,CAAC;IAEvB;QACE,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAChB,KAAK,EACL,MAAM,EACN,MAAM,EACN,MAAM,EACN,YAAY,EACZ,OAAO,EACP,IAAI,EACJ,IAAI,CACL,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,IAA6B,EAAE,QAAsB;QAC7D,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC;QACnC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC;QAChC,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC;YAC3D,OAAO,8BAA8B,CAAC;QACxC,CAAC;QACD,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;YACnC,OAAO,4BAA4B,CAAC;QACtC,CAAC;QACD,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;YACnC,IAAI,mBAAmB,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC5B,OAAO,oBAAoB,EAAE,EAAE,CAAC;YAClC,CAAC;YACD,MAAM,MAAM,GAAG,eAAe,CAAC,EAAE,CAAC,CAAC;YACnC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,OAAO,sBAAsB,MAAM,CAAC,MAAO,0CAA0C,CAAC;YACxF,CAAC;YACD,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACtD,MAAM,EAAE,CAAC,SAAS,CAAC,EAAE,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;YAC5C,OAAO,WAAW,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,aAAa,EAAE,EAAE,CAAC;QACnE,CAAC;QAAC,OAAO,CAAU,EAAE,CAAC;YACpB,OAAO,oBAAoB,CAAC,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;CACF;AAED,MAAM,UAAU,mBAAmB;IACjC,OAAO,IAAI,oBAAoB,EAAE,CAAC,MAAM,EAAE,CAAC;AAC7C,CAAC"}
+{"version":3,"file":"write-file-tool.js","sourceRoot":"","sources":["../../src/builtin/write-file-tool.ts"],"names":[],"mappings":"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"}

package/lib/common-adapter-tools.d.ts

@@ -1,46 +1,13 @@
 /**
- * Group Management — 方法规范与 Tool 工厂
+ * Agent-side group management tool creation.
  *
- * 设计理念：
- *   各 IM 平台在适配器内自行实现群管方法（kickMember、muteMember 等），
- *   并自行注册 Tool；平台说明使用包内 `skills/<adapter>/SKILL.md`。
- *
- * 使用方式（在各适配器 start 或注册方法中）：
- *
- *   import { createGroupManagementTools, GROUP_MANAGEMENT_SKILL_KEYWORDS, GROUP_MANAGEMENT_SKILL_TAGS } from '@zhin.js/agent';
- *   const tools = createGroupManagementTools(this, this.name);
- *   tools.forEach(t => agent.addTool(t));
+ * Delegates interface, specs, constants, and buildMethodArgs to @zhin.js/core,
+ * then adapts the result to the agent Tool type.
  */
-import type { Tool, ToolPermissionLevel } from './orchestrator/types.js';
-export interface IGroupManagement {
-    kickMember?(botId: string, sceneId: string, userId: string): Promise<any>;
-    muteMember?(botId: string, sceneId: string, userId: string, duration?: number): Promise<any>;
-    setMemberNickname?(botId: string, sceneId: string, userId: string, nickname: string): Promise<any>;
-    setAdmin?(botId: string, sceneId: string, userId: string, enable?: boolean): Promise<any>;
-    listMembers?(botId: string, sceneId: string): Promise<any>;
-    banMember?(botId: string, sceneId: string, userId: string, reason?: string): Promise<any>;
-    unbanMember?(botId: string, sceneId: string, userId: string): Promise<any>;
-    setGroupName?(botId: string, sceneId: string, name: string): Promise<any>;
-    muteAll?(botId: string, sceneId: string, enable?: boolean): Promise<any>;
-    getGroupInfo?(botId: string, sceneId: string): Promise<any>;
-}
-export interface GroupMethodSpec {
-    method: keyof IGroupManagement;
-    toolSuffix: string;
-    description: string;
-    keywords: string[];
-    permissionLevel: ToolPermissionLevel;
-    extraParams: Record<string, {
-        type: string;
-        description: string;
-        default?: any;
-    }>;
-    extraRequired?: string[];
-    preExecutable?: boolean;
-}
-export declare const GROUP_METHOD_SPECS: GroupMethodSpec[];
-export declare const GROUP_MANAGEMENT_SKILL_TAGS: string[];
-export declare const GROUP_MANAGEMENT_SKILL_KEYWORDS: string[];
+import { buildMethodArgs, GROUP_METHOD_SPECS, GROUP_MANAGEMENT_SKILL_KEYWORDS, GROUP_MANAGEMENT_SKILL_TAGS } from '@zhin.js/core';
+import type { IGroupManagement, GroupMethodSpec } from '@zhin.js/core';
+import type { Tool } from './orchestrator/types.js';
+export type { IGroupManagement, GroupMethodSpec };
+export { GROUP_METHOD_SPECS, GROUP_MANAGEMENT_SKILL_KEYWORDS, GROUP_MANAGEMENT_SKILL_TAGS, buildMethodArgs };
 export declare function createGroupManagementTools(adapter: IGroupManagement, prefix: string): Tool[];
-export declare function buildMethodArgs(method: keyof IGroupManagement, botId: string, sceneId: string, rest: Record<string, any>): any[];
 //# sourceMappingURL=common-adapter-tools.d.ts.map

package/lib/common-adapter-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"common-adapter-tools.d.ts","sourceRoot":"","sources":["../src/common-adapter-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,mBAAmB,EAAa,MAAM,yBAAyB,CAAC;AAMpF,MAAM,WAAW,gBAAgB;IAC/B,UAAU,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1E,UAAU,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC7F,iBAAiB,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACnG,QAAQ,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1F,WAAW,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3D,SAAS,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1F,WAAW,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3E,YAAY,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1E,OAAO,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACzE,YAAY,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;CAC7D;AAMD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,gBAAgB,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,eAAe,EAAE,mBAAmB,CAAC;IACrC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,GAAG,CAAA;KAAE,CAAC,CAAC;IAClF,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,eAAO,MAAM,kBAAkB,EAAE,eAAe,EA8G/C,CAAC;AAMF,eAAO,MAAM,2BAA2B,UAAyC,CAAC;AAClF,eAAO,MAAM,+BAA+B,UAG3C,CAAC;AAMF,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,MAAM,GACb,IAAI,EAAE,CAkCR;AAMD,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,gBAAgB,EAC9B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACxB,GAAG,EAAE,CAcP"}
+{"version":3,"file":"common-adapter-tools.d.ts","sourceRoot":"","sources":["../src/common-adapter-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAEL,eAAe,EACf,kBAAkB,EAClB,+BAA+B,EAC/B,2BAA2B,EAC5B,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,KAAK,EAAE,IAAI,EAAkC,MAAM,yBAAyB,CAAC;AAEpF,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,+BAA+B,EAAE,2BAA2B,EAAE,eAAe,EAAE,CAAC;AAE7G,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,MAAM,GACb,IAAI,EAAE,CAoBR"}

package/lib/common-adapter-tools.js

@@ -1,189 +1,30 @@
 /**
- * Group Management — 方法规范与 Tool 工厂
+ * Agent-side group management tool creation.
  *
- * 设计理念：
- *   各 IM 平台在适配器内自行实现群管方法（kickMember、muteMember 等），
- *   并自行注册 Tool；平台说明使用包内 `skills/<adapter>/SKILL.md`。
- *
- * 使用方式（在各适配器 start 或注册方法中）：
- *
- *   import { createGroupManagementTools, GROUP_MANAGEMENT_SKILL_KEYWORDS, GROUP_MANAGEMENT_SKILL_TAGS } from '@zhin.js/agent';
- *   const tools = createGroupManagementTools(this, this.name);
- *   tools.forEach(t => agent.addTool(t));
+ * Delegates interface, specs, constants, and buildMethodArgs to @zhin.js/core,
+ * then adapts the result to the agent Tool type.
  */
-export const GROUP_METHOD_SPECS = [
-    {
-        method: 'kickMember',
-        toolSuffix: 'kick_member',
-        description: '将成员踢出群/服务器。适用于严重违规、广告号等需要移除的场景。踢出后该成员将无法再进入群聊（部分平台可重新邀请）。如果只需要用户名而没有 user_id，请先调用 list_members 查询',
-        keywords: ['踢', 'kick', '移除', '踢出'],
-        permissionLevel: 'group_admin',
-        extraParams: {
-            user_id: { type: 'string', description: '目标用户 ID（如果只有昵称，先用 list_members 查询获取）' },
-        },
-        extraRequired: ['user_id'],
-    },
-    {
-        method: 'muteMember',
-        toolSuffix: 'mute_member',
-        description: '禁言或解除禁言群成员。适用于违规发言、刷屏、骚扰他人等需要临时限制发言的场景。duration 单位为秒，传 0 表示解除禁言。默认禁言 10 分钟(600秒)。如果只有昵称而没有 user_id，请先调用 list_members 查询',
-        keywords: ['禁言', 'mute', '静音', '解除禁言', '解禁', '闭嘴'],
-        permissionLevel: 'group_admin',
-        extraParams: {
-            user_id: { type: 'string', description: '目标用户 ID（如果只有昵称，先用 list_members 查询获取）' },
-            duration: { type: 'number', description: '禁言时长(秒)，0=解除禁言，默认600(10分钟)。常用值：60=1分钟, 600=10分钟, 3600=1小时, 86400=1天', default: 600 },
-        },
-        extraRequired: ['user_id'],
-    },
-    {
-        method: 'setMemberNickname',
-        toolSuffix: 'set_nickname',
-        description: '设置群成员的群昵称/名片。仅修改群内显示名称，不影响用户的全局昵称。如果只有昵称而没有 user_id，请先调用 list_members 查询',
-        keywords: ['昵称', '名片', 'nickname', 'card', '改名片'],
-        permissionLevel: 'group_admin',
-        extraParams: {
-            user_id: { type: 'string', description: '目标用户 ID（如果只有昵称，先用 list_members 查询获取）' },
-            nickname: { type: 'string', description: '新的群昵称/名片' },
-        },
-        extraRequired: ['user_id', 'nickname'],
-    },
-    {
-        method: 'setAdmin',
-        toolSuffix: 'set_admin',
-        description: '设置或取消群管理员。注意：此操作需要群主权限，普通管理员无法执行。enable=true 为设置管理员，enable=false 为取消管理员。如果只有昵称而没有 user_id，请先调用 list_members 查询',
-        keywords: ['管理员', 'admin', '设置管理', '取消管理', '提升管理', '撤销管理'],
-        permissionLevel: 'group_owner',
-        extraParams: {
-            user_id: { type: 'string', description: '目标用户 ID（如果只有昵称，先用 list_members 查询获取）' },
-            enable: { type: 'boolean', description: 'true=设置为管理员，false=取消管理员身份', default: true },
-        },
-        extraRequired: ['user_id'],
-    },
-    {
-        method: 'listMembers',
-        toolSuffix: 'list_members',
-        description: '获取群/服务器成员列表。返回所有成员的 ID、昵称、名片、角色等信息。当用户提供昵称/名片而非 ID 时，应先调用此工具查询成员列表，从中匹配到目标用户的 user_id，再执行禁言、踢人等操作',
-        keywords: ['成员', '列表', 'members', 'list', '查找', '搜索用户'],
-        permissionLevel: 'user',
-        extraParams: {},
-        preExecutable: true,
-    },
-    {
-        method: 'banMember',
-        toolSuffix: 'ban_member',
-        description: '永久封禁成员（拉入黑名单）。与踢人(kick)不同，封禁后该成员无法再加入群聊。适用于恶意用户、严重违规等需要永久禁止的场景。如果只有昵称而没有 user_id，请先调用 list_members 查询',
-        keywords: ['封禁', 'ban', '拉黑', '黑名单'],
-        permissionLevel: 'group_admin',
-        extraParams: {
-            user_id: { type: 'string', description: '目标用户 ID（如果只有昵称，先用 list_members 查询获取）' },
-            reason: { type: 'string', description: '封禁原因（将记录在封禁日志中）' },
-        },
-        extraRequired: ['user_id'],
-    },
-    {
-        method: 'unbanMember',
-        toolSuffix: 'unban_member',
-        description: '解除封禁，将成员从黑名单中移除。解除后该成员可以重新加入群聊。如果只有昵称而没有 user_id，请先调用 list_members 查询',
-        keywords: ['解封', 'unban', '解除封禁', '移出黑名单'],
-        permissionLevel: 'group_admin',
-        extraParams: {
-            user_id: { type: 'string', description: '目标用户 ID（如果只有昵称，先用 list_members 查询获取）' },
-        },
-        extraRequired: ['user_id'],
-    },
-    {
-        method: 'setGroupName',
-        toolSuffix: 'set_group_name',
-        description: '修改群/服务器名称。修改后所有成员立即可见新群名',
-        keywords: ['群名', '改名', 'group name', '修改群名'],
-        permissionLevel: 'group_admin',
-        extraParams: {
-            name: { type: 'string', description: '新群名称' },
-        },
-        extraRequired: ['name'],
-    },
-    {
-        method: 'muteAll',
-        toolSuffix: 'mute_all',
-        description: '开启或关闭全员禁言。开启后除管理员外所有成员都无法发言。适用于紧急维护、重要通知、聊天秩序混乱等场景。enable=true 开启，enable=false 解除',
-        keywords: ['全员禁言', 'mute all', '全体禁言', '全体解禁'],
-        permissionLevel: 'group_admin',
-        extraParams: {
-            enable: { type: 'boolean', description: 'true=开启全员禁言，false=解除全员禁言', default: true },
-        },
-    },
-    {
-        method: 'getGroupInfo',
-        toolSuffix: 'get_group_info',
-        description: '获取群/服务器基本信息，包括群名、群主、成员数量、创建时间等。用于了解群聊概况',
-        keywords: ['群信息', 'group info', '群资料', '群详情'],
-        permissionLevel: 'user',
-        extraParams: {},
-        preExecutable: true,
-    },
-];
-// ============================================================================
-// Skill 常量
-// ============================================================================
-export const GROUP_MANAGEMENT_SKILL_TAGS = ['group', 'management', 'im', 'admin'];
-export const GROUP_MANAGEMENT_SKILL_KEYWORDS = [
-    '群管理', '踢人', '禁言', '封禁', '管理员', '群名',
-    '成员', 'kick', 'mute', 'ban', 'admin', 'members',
-];
-// ============================================================================
-// 工厂
-// ============================================================================
+import { createGroupManagementToolsRaw, buildMethodArgs, GROUP_METHOD_SPECS, GROUP_MANAGEMENT_SKILL_KEYWORDS, GROUP_MANAGEMENT_SKILL_TAGS, } from '@zhin.js/core';
+export { GROUP_METHOD_SPECS, GROUP_MANAGEMENT_SKILL_KEYWORDS, GROUP_MANAGEMENT_SKILL_TAGS, buildMethodArgs };
 export function createGroupManagementTools(adapter, prefix) {
-    const tools = [];
-    for (const spec of GROUP_METHOD_SPECS) {
-        const fn = adapter[spec.method];
-        if (typeof fn !== 'function')
-            continue;
-        const properties = {
-            bot_id: { type: 'string', description: 'Bot ID', contextKey: 'botId' },
-            scene_id: { type: 'string', description: '群/服务器 ID', contextKey: 'sceneId' },
-        };
-        const required = ['bot_id', 'scene_id'];
-        for (const [name, schema] of Object.entries(spec.extraParams)) {
-            properties[name] = schema;
-        }
-        if (spec.extraRequired)
-            required.push(...spec.extraRequired);
-        const boundFn = fn.bind(adapter);
-        tools.push({
-            name: `${prefix}_${spec.toolSuffix}`,
-            description: `${spec.description} (${prefix})`,
-            parameters: { type: 'object', properties, required },
-            execute: async (args) => {
-                const { bot_id, scene_id, ...rest } = args;
-                const methodArgs = buildMethodArgs(spec.method, bot_id, scene_id, rest);
-                return boundFn.apply(adapter, methodArgs);
+    return createGroupManagementToolsRaw(adapter, prefix, (spec, prefix, execute) => ({
+        name: `${prefix}_${spec.toolSuffix}`,
+        description: `${spec.description} (${prefix})`,
+        parameters: {
+            type: 'object',
+            properties: {
+                bot_id: { type: 'string', description: 'Bot ID', contextKey: 'botId' },
+                scene_id: { type: 'string', description: '群/服务器 ID', contextKey: 'sceneId' },
+                ...Object.fromEntries(Object.entries(spec.extraParams)),
             },
-            tags: ['group', 'management', prefix],
-            keywords: spec.keywords,
-            permissionLevel: spec.permissionLevel,
-            scopes: ['group'],
-            preExecutable: spec.preExecutable,
-        });
-    }
-    return tools;
-}
-// ============================================================================
-// 参数映射
-// ============================================================================
-export function buildMethodArgs(method, botId, sceneId, rest) {
-    switch (method) {
-        case 'kickMember': return [botId, sceneId, rest.user_id];
-        case 'muteMember': return [botId, sceneId, rest.user_id, rest.duration ?? 600];
-        case 'setMemberNickname': return [botId, sceneId, rest.user_id, rest.nickname];
-        case 'setAdmin': return [botId, sceneId, rest.user_id, rest.enable ?? true];
-        case 'listMembers': return [botId, sceneId];
-        case 'banMember': return [botId, sceneId, rest.user_id, rest.reason];
-        case 'unbanMember': return [botId, sceneId, rest.user_id];
-        case 'setGroupName': return [botId, sceneId, rest.name];
-        case 'muteAll': return [botId, sceneId, rest.enable ?? true];
-        case 'getGroupInfo': return [botId, sceneId];
-        default: return [botId, sceneId, ...Object.values(rest)];
-    }
+            required: ['bot_id', 'scene_id', ...(spec.extraRequired ?? [])],
+        },
+        execute,
+        tags: ['group', 'management', prefix],
+        keywords: spec.keywords,
+        permissionLevel: spec.permissionLevel,
+        scopes: ['group'],
+        preExecutable: spec.preExecutable,
+    }));
 }
 //# sourceMappingURL=common-adapter-tools.js.map

package/lib/common-adapter-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"common-adapter-tools.js","sourceRoot":"","sources":["../src/common-adapter-tools.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"common-adapter-tools.js","sourceRoot":"","sources":["../src/common-adapter-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,6BAA6B,EAC7B,eAAe,EACf,kBAAkB,EAClB,+BAA+B,EAC/B,2BAA2B,GAC5B,MAAM,eAAe,CAAC;AAKvB,OAAO,EAAE,kBAAkB,EAAE,+BAA+B,EAAE,2BAA2B,EAAE,eAAe,EAAE,CAAC;AAE7G,MAAM,UAAU,0BAA0B,CACxC,OAAyB,EACzB,MAAc;IAEd,OAAO,6BAA6B,CAAO,OAAO,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;QACtF,IAAI,EAAE,GAAG,MAAM,IAAI,IAAI,CAAC,UAAU,EAAE;QACpC,WAAW,EAAE,GAAG,IAAI,CAAC,WAAW,KAAK,MAAM,GAAG;QAC9C,UAAU,EAAE;YACV,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE;gBACtE,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE;gBAC5E,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;aACxD;YACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,CAAC,IAAI,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC;SAChE;QACD,OAAO;QACP,IAAI,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC;QACrC,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,eAAe,EAAE,IAAI,CAAC,eAAsC;QAC5D,MAAM,EAAE,CAAC,OAAO,CAAgB;QAChC,aAAa,EAAE,IAAI,CAAC,aAAa;KAClC,CAAC,CAAC,CAAC;AACN,CAAC"}

package/lib/deferred-worker-runner.d.ts

@@ -1,6 +1,6 @@
 import type { AIProvider, AgentTool } from '@zhin.js/core';
 import type { ModelRegistry } from '@zhin.js/ai';
-import type { ZhinAgentConfig } from './zhin-agent/config.js';
+import type { ZhinAgentConfig, ExecApprovalMode } from './zhin-agent/config.js';
 import type { ToolContext } from '@zhin.js/core';
 /** 回传给主 Agent 的摘要最大字符数 */
 export declare const DEFAULT_WORKER_SUMMARY_MAX_CHARS = 1500;
@@ -14,15 +14,26 @@ export interface DeferredWorkerRunOptions {
     maxToolResults: number;
     maxIterations?: number;
     execPolicyConfig?: Required<ZhinAgentConfig>;
+    execApprovalMode?: ExecApprovalMode;
     modelRegistry?: ModelRegistry | null;
     provider: AIProvider;
     summaryMaxChars?: number;
+    onEvent?: (event: DeferredWorkerLifecycleEvent) => void | Promise<void>;
+}
+export interface DeferredWorkerLifecycleEvent {
+    phase: 'start' | 'finish';
+    goal: string;
+    toolQuery?: string;
+    status?: 'ok' | 'partial' | 'error';
+    loadedToolNames?: string[];
+    iterations?: number;
+    error?: string;
 }
 export interface DeferredWorkerResult {
     summary: string;
     loadedToolNames: string[];
     iterations: number;
-    status: 'ok' | 'error';
+    status: 'ok' | 'partial' | 'error';
 }
 export declare class DeferredWorkerRunner {
     runSync(options: DeferredWorkerRunOptions): Promise<DeferredWorkerResult>;

package/lib/deferred-worker-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deferred-worker-runner.d.ts","sourceRoot":"","sources":["../src/deferred-worker-runner.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAS3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAM9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAMjD,0BAA0B;AAC1B,eAAO,MAAM,gCAAgC,OAAO,CAAC;AAErD,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,SAAS,EAAE,CAAC;IAC7B,eAAe,EAAE,SAAS,EAAE,CAAC;IAC7B,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACvC,MAAM,EAAE,WAAW,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC;IAC7C,aAAa,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IACrC,QAAQ,EAAE,UAAU,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC;CACxB;AAED,qBAAa,oBAAoB;IACzB,OAAO,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,oBAAoB,CAAC;CA2JhF"}
+{"version":3,"file":"deferred-worker-runner.d.ts","sourceRoot":"","sources":["../src/deferred-worker-runner.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAe3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAOhF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAMjD,0BAA0B;AAC1B,eAAO,MAAM,gCAAgC,OAAO,CAAC;AAErD,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,SAAS,EAAE,CAAC;IAC7B,eAAe,EAAE,SAAS,EAAE,CAAC;IAC7B,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACvC,MAAM,EAAE,WAAW,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC;IAC7C,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,aAAa,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IACrC,QAAQ,EAAE,UAAU,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,4BAA4B,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzE;AAED,MAAM,WAAW,4BAA4B;IAC3C,KAAK,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC;IACpC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC;CACpC;AAED,qBAAa,oBAAoB;IACzB,OAAO,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,oBAAoB,CAAC;CA+MhF"}