@zhin.js/core 1.0.25 → 1.0.26

package/lib/built/permission.js.map

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

package/lib/built/skill.d.ts

@@ -0,0 +1,117 @@
+/**
+ * SkillFeature — AI 可见能力描述层
+ *
+ * 核心概念：
+ *   Plugin = 运行时容器（生命周期、服务注册、中间件）
+ *   Skill  = AI 可见的能力接口（名称、描述、工具列表）
+ *
+ * 每个 Plugin 可以声明一个 Skill 描述，告诉 AI Agent：
+ *   "我叫什么、我能做什么、我有哪些工具"
+ *
+ * SkillFeature 全局收集所有 Skill，供 Agent 进行两级过滤：
+ *   1. 粗筛：根据用户消息选择相关 Skill
+ *   2. 细筛：从选中 Skill 内选择具体 Tool
+ */
+import { Feature, FeatureJSON } from '../feature.js';
+import type { Tool } from '../types.js';
+/**
+ * Skill — AI 可见的能力描述
+ */
+export interface Skill {
+    /** 技能名称（通常与插件名一致） */
+    name: string;
+    /** 技能描述（AI 用来理解这个 Skill 的用途） */
+    description: string;
+    /** 该 Skill 提供的工具列表 */
+    tools: Tool[];
+    /**
+     * 触发关键词
+     * 当用户消息包含这些关键词时，优先选择此 Skill
+     */
+    keywords?: string[];
+    /**
+     * 分类标签
+     * 用于按领域分组（如 'news', 'weather', 'entertainment'）
+     */
+    tags?: string[];
+    /** 来源插件名 */
+    pluginName: string;
+}
+/**
+ * Skill 元数据 — 开发者在插件中声明
+ * 由 plugin.declareSkill() 注册
+ */
+export interface SkillMetadata {
+    /** 技能描述（必填） */
+    description: string;
+    /** 触发关键词（可选，自动从工具中聚合） */
+    keywords?: string[];
+    /** 分类标签（可选） */
+    tags?: string[];
+}
+export interface SkillContextExtensions {
+    /**
+     * 声明本插件的 Skill 元数据
+     * 调用后，插件的工具会自动聚合为一个 Skill 注册到 SkillFeature
+     */
+    declareSkill(metadata: SkillMetadata): void;
+}
+declare module '../plugin.js' {
+    namespace Plugin {
+        interface Extensions extends SkillContextExtensions {
+        }
+        interface Contexts {
+            skill: SkillFeature;
+        }
+    }
+}
+export declare class SkillFeature extends Feature<Skill> {
+    #private;
+    readonly name: "skill";
+    readonly icon = "Brain";
+    readonly desc = "\u6280\u80FD";
+    /** 按名称索引 */
+    readonly byName: Map<string, Skill>;
+    /**
+     * 添加 Skill
+     */
+    add(skill: Skill, pluginName: string): () => void;
+    /**
+     * 移除 Skill
+     */
+    remove(skill: Skill): boolean;
+    /**
+     * 按名称获取 Skill
+     */
+    get(name: string): Skill | undefined;
+    /**
+     * 获取所有已注册 Skill
+     */
+    getAll(): Skill[];
+    /**
+     * 按关键词/标签搜索相关 Skill
+     * 返回按相关性排序的 Skill 列表
+     */
+    search(query: string, options?: {
+        maxResults?: number;
+    }): Skill[];
+    /**
+     * 获取所有 Skill 的工具（扁平化）
+     */
+    collectAllTools(): Tool[];
+    /**
+     * 已注册 Skill 数量
+     */
+    get size(): number;
+    /**
+     * 序列化为 JSON
+     */
+    toJSON(pluginName?: string): FeatureJSON;
+    /**
+     * 提供给 Plugin.prototype 的扩展方法
+     */
+    get extensions(): {
+        declareSkill(metadata: SkillMetadata): void;
+    };
+}
+//# sourceMappingURL=skill.d.ts.map

package/lib/built/skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../src/built/skill.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAMxC;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IAEb,gCAAgC;IAChC,WAAW,EAAE,MAAM,CAAC;IAEpB,sBAAsB;IACtB,KAAK,EAAE,IAAI,EAAE,CAAC;IAEd;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB,YAAY;IACZ,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,eAAe;IACf,WAAW,EAAE,MAAM,CAAC;IAEpB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB,eAAe;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAMD,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,YAAY,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;CAC7C;AAED,OAAO,QAAQ,cAAc,CAAC;IAC5B,UAAU,MAAM,CAAC;QACf,UAAU,UAAW,SAAQ,sBAAsB;SAAG;QACtD,UAAU,QAAQ;YAChB,KAAK,EAAE,YAAY,CAAC;SACrB;KACF;CACF;AAMD,qBAAa,YAAa,SAAQ,OAAO,CAAC,KAAK,CAAC;;IAC9C,QAAQ,CAAC,IAAI,EAAG,OAAO,CAAU;IACjC,QAAQ,CAAC,IAAI,WAAW;IACxB,QAAQ,CAAC,IAAI,kBAAQ;IAErB,YAAY;IACZ,QAAQ,CAAC,MAAM,qBAA4B;IAE3C;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,IAAI;IAKjD;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO;IAK7B;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAIpC;;OAEG;IACH,MAAM,IAAI,KAAK,EAAE;IAIjB;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,KAAK,EAAE;IAWjE;;OAEG;IACH,eAAe,IAAI,IAAI,EAAE;IAQzB;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IA0CD;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,WAAW;IAiBxC;;OAEG;IACH,IAAI,UAAU;+BAGa,aAAa;MAiDvC;CACF"}

package/lib/built/skill.js

@@ -0,0 +1,191 @@
+/**
+ * SkillFeature — AI 可见能力描述层
+ *
+ * 核心概念：
+ *   Plugin = 运行时容器（生命周期、服务注册、中间件）
+ *   Skill  = AI 可见的能力接口（名称、描述、工具列表）
+ *
+ * 每个 Plugin 可以声明一个 Skill 描述，告诉 AI Agent：
+ *   "我叫什么、我能做什么、我有哪些工具"
+ *
+ * SkillFeature 全局收集所有 Skill，供 Agent 进行两级过滤：
+ *   1. 粗筛：根据用户消息选择相关 Skill
+ *   2. 细筛：从选中 Skill 内选择具体 Tool
+ */
+import { Feature } from '../feature.js';
+import { getPlugin } from '../plugin.js';
+// ============================================================================
+// SkillFeature 实现
+// ============================================================================
+export class SkillFeature extends Feature {
+    name = 'skill';
+    icon = 'Brain';
+    desc = '技能';
+    /** 按名称索引 */
+    byName = new Map();
+    /**
+     * 添加 Skill
+     */
+    add(skill, pluginName) {
+        this.byName.set(skill.name, skill);
+        return super.add(skill, pluginName);
+    }
+    /**
+     * 移除 Skill
+     */
+    remove(skill) {
+        this.byName.delete(skill.name);
+        return super.remove(skill);
+    }
+    /**
+     * 按名称获取 Skill
+     */
+    get(name) {
+        return this.byName.get(name);
+    }
+    /**
+     * 获取所有已注册 Skill
+     */
+    getAll() {
+        return [...this.items];
+    }
+    /**
+     * 按关键词/标签搜索相关 Skill
+     * 返回按相关性排序的 Skill 列表
+     */
+    search(query, options) {
+        const maxResults = options?.maxResults ?? 5;
+        const scored = this.items
+            .map(skill => ({ skill, score: this.#scoreSkill(skill, query) }))
+            .filter(({ score }) => score > 0)
+            .sort((a, b) => b.score - a.score)
+            .slice(0, maxResults);
+        return scored.map(({ skill }) => skill);
+    }
+    /**
+     * 获取所有 Skill 的工具（扁平化）
+     */
+    collectAllTools() {
+        const tools = [];
+        for (const skill of this.items) {
+            tools.push(...skill.tools);
+        }
+        return tools;
+    }
+    /**
+     * 已注册 Skill 数量
+     */
+    get size() {
+        return this.items.length;
+    }
+    /**
+     * 简单的关键词匹配评分
+     */
+    #scoreSkill(skill, query) {
+        const lowerQuery = query.toLowerCase();
+        let score = 0;
+        // 关键词精确匹配
+        if (skill.keywords) {
+            for (const kw of skill.keywords) {
+                if (lowerQuery.includes(kw.toLowerCase()))
+                    score += 1.0;
+            }
+        }
+        // 标签匹配
+        if (skill.tags) {
+            for (const tag of skill.tags) {
+                if (lowerQuery.includes(tag.toLowerCase()))
+                    score += 0.5;
+            }
+        }
+        // 名称匹配
+        if (lowerQuery.includes(skill.name.toLowerCase()))
+            score += 0.3;
+        // 描述匹配（双向）
+        const lowerDesc = skill.description.toLowerCase();
+        if (lowerDesc.includes(lowerQuery))
+            score += 0.2;
+        if (lowerQuery.includes(lowerDesc))
+            score += 0.15;
+        // 工具名/描述匹配
+        for (const tool of skill.tools) {
+            if (lowerQuery.includes(tool.name.toLowerCase()))
+                score += 0.4;
+            if (tool.description && lowerQuery.includes(tool.description.toLowerCase().slice(0, 10))) {
+                score += 0.1;
+            }
+        }
+        return score;
+    }
+    /**
+     * 序列化为 JSON
+     */
+    toJSON(pluginName) {
+        const list = pluginName ? this.getByPlugin(pluginName) : this.items;
+        return {
+            name: this.name,
+            icon: this.icon,
+            desc: this.desc,
+            count: list.length,
+            items: list.map(s => ({
+                name: s.name,
+                desc: s.description,
+                toolCount: s.tools.length,
+                keywords: s.keywords,
+                tags: s.tags,
+            })),
+        };
+    }
+    /**
+     * 提供给 Plugin.prototype 的扩展方法
+     */
+    get extensions() {
+        const feature = this;
+        return {
+            declareSkill(metadata) {
+                const plugin = getPlugin();
+                const pluginName = plugin.name;
+                // 收集该插件注册的工具
+                const toolService = plugin.root.inject('tool');
+                let tools = [];
+                if (toolService && typeof toolService.getToolsByPlugin === 'function') {
+                    tools = toolService.getToolsByPlugin(pluginName);
+                }
+                else {
+                    // 回退：从插件本地工具获取
+                    tools = plugin.getAllTools?.() || [];
+                }
+                // 聚合关键词：开发者声明 + 工具自带
+                const allKeywords = new Set(metadata.keywords || []);
+                for (const tool of tools) {
+                    if (tool.keywords) {
+                        for (const kw of tool.keywords) {
+                            allKeywords.add(kw);
+                        }
+                    }
+                }
+                // 聚合标签
+                const allTags = new Set(metadata.tags || []);
+                for (const tool of tools) {
+                    if (tool.tags) {
+                        for (const tag of tool.tags) {
+                            allTags.add(tag);
+                        }
+                    }
+                }
+                const skill = {
+                    name: pluginName,
+                    description: metadata.description,
+                    tools,
+                    keywords: Array.from(allKeywords),
+                    tags: Array.from(allTags),
+                    pluginName,
+                };
+                const dispose = feature.add(skill, pluginName);
+                plugin.recordFeatureContribution(feature.name, pluginName);
+                plugin.onDispose(dispose);
+            },
+        };
+    }
+}
+//# sourceMappingURL=skill.js.map

package/lib/built/skill.js.map

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

package/lib/built/tool.d.ts

@@ -1,9 +1,10 @@
 /**
- * Tool Service
- * 统一的工具管理服务，支持 Tool ↔ Command 互转
+ * ToolFeature — 统一的工具管理服务
+ * 支持 Tool ↔ Command 互转
  */
+import { Feature, FeatureJSON } from "../feature.js";
 import { MessageCommand } from "../command.js";
-import { Context, Plugin } from "../plugin.js";
+import { Plugin } from "../plugin.js";
 import type { Tool, ToolDefinition, RegisteredAdapter, ToolContext, ToolJsonSchema, ToolParametersSchema, PropertySchema, MaybePromise, ToolPermissionLevel, ToolScope } from "../types.js";
 /**
  * 权限级别优先级（数字越大权限越高）
@@ -35,29 +36,6 @@ export declare function generatePattern(tool: Tool): string;
 export declare function extractParamInfo(parameters: ToolJsonSchema): Tool.ParamInfo[];
 /**
  * 定义工具的辅助函数（提供类型推断）
- *
- * 使用泛型参数获得 execute 函数的类型检查，
- * 返回通用的 Tool 类型，可直接传给 addTool
- *
- * @example
- * ```typescript
- * const myTool = defineTool<{ name: string }>({
- *   name: 'greet',
- *   description: '打招呼',
- *   parameters: {
- *     type: 'object',
- *     properties: {
- *       name: { type: 'string', description: '名字' }
- *     },
- *     required: ['name']
- *   },
- *   execute: async (args) => {
- *     return `你好，${args.name}！`;  // args.name 有类型提示
- *   }
- * });
- *
- * plugin.addTool(myTool);  // 无需类型断言
- * ```
  */
 export declare function defineTool<TArgs extends Record<string, any> = Record<string, any>>(tool: ToolDefinition<TArgs>): Tool;
 /**
@@ -71,129 +49,30 @@ interface ParamDef {
 /**
  * ZhinTool 类
  * 提供类似 MessageCommand 的链式调用风格来定义工具
- *
- * @example
- * ```typescript
- * const weatherTool = new ZhinTool('weather')
- *   .desc('查询天气信息')
- *   .param('city', { type: 'string', description: '城市名称' }, true)
- *   .param('days', { type: 'number', description: '预报天数' })
- *   .platform('qq', 'telegram')
- *   .scope('group', 'private')
- *   .permission('user')
- *   // AI 调用时执行（必须）
- *   .execute(async (args, ctx) => {
- *     return `${args.city} 的天气是晴天`;
- *   })
- *   // 可选：命令回调（与 MessageCommand.action 一致）
- *   // 如果定义了此回调，会生成 Command
- *   .action(async (message, result) => {
- *     return `命令执行: ${result.params.city}`;
- *   });
- *
- * plugin.addTool(weatherTool);
- * ```
  */
 export declare class ZhinTool {
     #private;
-    /**
-     * 创建工具实例
-     * @param name 工具名称（唯一标识，建议使用 snake_case）
-     */
     constructor(name: string);
-    /** 获取工具名称 */
     get name(): string;
-    /** 获取工具描述 */
     get description(): string;
-    /** 获取有序的参数列表 */
     get params(): ParamDef[];
-    /**
-     * 设置工具描述
-     * @param description 工具描述（供 AI 和帮助系统使用）
-     */
     desc(description: string): this;
-    /**
-     * 添加参数（按调用顺序保持有序）
-     * @param name 参数名称
-     * @param schema 参数 Schema（类型、描述等）
-     * @param required 是否必填（默认 false）
-     */
     param(name: string, schema: PropertySchema, required?: boolean): this;
-    /**
-     * 设置支持的平台
-     * @param platforms 平台名称列表（如 'qq', 'telegram'）
-     */
     platform(...platforms: string[]): this;
-    /**
-     * 设置支持的场景
-     * @param scopes 场景类型列表（'private', 'group', 'channel'）
-     */
     scope(...scopes: ToolScope[]): this;
-    /**
-     * 设置权限级别
-     * @param level 权限级别（'user', 'group_admin', 'group_owner', 'bot_admin', 'owner'）
-     */
     permission(level: ToolPermissionLevel): this;
-    /**
-     * 添加旧版权限要求（兼容 MessageCommand）
-     * @param permissions 权限字符串列表
-     */
     permit(...permissions: string[]): this;
-    /**
-     * 添加标签
-     * @param tags 标签列表
-     */
     tag(...tags: string[]): this;
-    /**
-     * 设置是否隐藏
-     * @param value 是否隐藏（默认 true）
-     */
+    keyword(...keywords: string[]): this;
     hidden(value?: boolean): this;
-    /**
-     * 设置使用说明（命令配置）
-     * @param usage 使用说明列表
-     */
     usage(...usage: string[]): this;
-    /**
-     * 设置示例（命令配置）
-     * @param examples 示例列表
-     */
     examples(...examples: string[]): this;
-    /**
-     * 设置别名（命令配置）
-     * @param alias 别名列表
-     */
     alias(...alias: string[]): this;
-    /**
-     * 设置自定义命令模式
-     * @param pattern 命令模式（如 'weather <city> [days]'）
-     */
     pattern(pattern: string): this;
-    /**
-     * 设置 AI 工具执行函数
-     * @param callback 执行回调，入参是 (args, context)
-     */
     execute(callback: (args: Record<string, any>, context?: ToolContext) => MaybePromise<any>): this;
-    /**
-     * 设置命令回调（可选，与 MessageCommand.action 一致）
-     * 如果定义了此回调，会自动生成 Command
-     * 入参是 (message, matchResult)
-     *
-     * @param callback 命令回调
-     */
     action(callback: MessageCommand.Callback<RegisteredAdapter>): this;
-    /**
-     * 转换为 Tool 对象
-     */
     toTool(): Tool;
-    /**
-     * 获取 action 回调（命令回调，如果有）
-     */
     getActionCallback(): MessageCommand.Callback<RegisteredAdapter> | undefined;
-    /**
-     * 转换为 JSON 格式（供 AI 使用，不包含 execute 函数）
-     * 符合 OpenAI Function Calling 规范
-     */
     toJSON(): {
         name: string;
         description: string;
@@ -203,13 +82,7 @@ export declare class ZhinTool {
         permissionLevel?: ToolPermissionLevel;
         tags?: string[];
     };
-    /**
-     * 输出帮助信息（类似 MessageCommand）
-     */
     get help(): string;
-    /**
-     * 输出简短信息
-     */
     toString(): string;
 }
 export declare function isZhinTool(obj: any): obj is ZhinTool;
@@ -218,7 +91,7 @@ export declare function isZhinTool(obj: any): obj is ZhinTool;
  */
 export type ToolInput = Tool | ZhinTool;
 /**
- * ToolService 扩展方法类型
+ * ToolContext 扩展方法类型
  */
 export interface ToolContextExtensions {
     /** 添加工具（自动生成命令） */
@@ -231,51 +104,85 @@ declare module "../plugin.js" {
         interface Extensions extends ToolContextExtensions {
         }
         interface Contexts {
-            tool: ToolService;
+            tool: ToolFeature;
         }
     }
 }
 /**
- * 工具服务
+ * 将 Tool 转换为 MessageCommand
+ */
+declare function toolToCommand(tool: Tool): MessageCommand<RegisteredAdapter>;
+/**
+ * 将 MessageCommand 转换为 Tool
  */
-export interface ToolService {
-    /** 所有注册的工具 */
-    readonly tools: Map<string, Tool>;
-    /** 工具对应的命令（如果生成了） */
-    readonly toolCommands: Map<string, MessageCommand<RegisteredAdapter>>;
-    /** 添加工具（支持 Tool 对象或 ZhinTool 实例） */
-    add(tool: ToolInput, pluginName: string, generateCommand?: boolean): () => void;
-    /** 移除工具 */
-    remove(name: string): boolean;
-    /** 获取工具 */
+declare function commandToToolFn(command: MessageCommand<RegisteredAdapter>, pluginName: string): Tool;
+export declare class ToolFeature extends Feature<Tool> {
+    #private;
+    readonly name: "tool";
+    readonly icon = "Wrench";
+    readonly desc = "\u5DE5\u5177";
+    /** 按名称索引 */
+    readonly byName: Map<string, Tool>;
+    /** 工具对应的命令 */
+    readonly toolCommands: Map<string, MessageCommand<"process">>;
+    /**
+     * 添加工具
+     * @param toolInput 工具或 ZhinTool 实例
+     * @param pluginName 注册插件名
+     * @param generateCommand 是否生成命令（默认 true）
+     */
+    addTool(toolInput: ToolInput, pluginName: string, generateCommand?: boolean): () => void;
+    /**
+     * 移除工具
+     */
+    removeTool(name: string): boolean;
+    /**
+     * 获取工具
+     */
     get(name: string): Tool | undefined;
-    /** 获取所有工具 */
+    /**
+     * 获取所有工具
+     */
     getAll(): Tool[];
-    /** 根据标签过滤工具 */
+    /**
+     * 根据标签过滤工具
+     */
     getByTags(tags: string[]): Tool[];
-    /** 执行工具 */
+    /**
+     * 执行工具
+     */
     execute(name: string, args: Record<string, any>, context?: ToolContext): Promise<any>;
-    /** 将 Command 转换为 Tool */
+    /**
+     * 将 Command 转换为 Tool
+     */
     commandToTool(command: MessageCommand<RegisteredAdapter>, pluginName: string): Tool;
-    /** 收集所有可用工具（包括从 Command 转换的） */
+    /**
+     * 收集所有可用工具（包括从 Command 转换的）
+     */
     collectAll(plugin: Plugin): Tool[];
     /**
      * 根据上下文过滤工具
-     * 检查平台、场景、权限是否匹配
      */
     filterByContext(tools: Tool[], context: ToolContext): Tool[];
+    /**
+     * 按插件名获取工具
+     */
+    getToolsByPlugin(pluginName: string): Tool[];
+    /**
+     * 兼容旧接口：tools Map
+     */
+    get tools(): Map<string, Tool>;
+    /**
+     * 序列化为 JSON
+     */
+    toJSON(pluginName?: string): FeatureJSON;
+    /**
+     * 提供给 Plugin.prototype 的扩展方法
+     */
+    get extensions(): {
+        addTool(tool: ToolInput): () => void;
+        addToolOnly(tool: ToolInput): () => void;
+    };
 }
-/**
- * 将 Tool 转换为 MessageCommand
- */
-declare function toolToCommand(tool: Tool): MessageCommand<RegisteredAdapter>;
-/**
- * 将 MessageCommand 转换为 Tool
- */
-declare function commandToTool(command: MessageCommand<RegisteredAdapter>, pluginName: string): Tool;
-/**
- * 创建工具服务 Context
- */
-export declare function createToolService(): Context<'tool', ToolContextExtensions>;
-export { toolToCommand, commandToTool, canAccessTool, inferPermissionLevel, hasPermissionLevel, PERMISSION_LEVEL_PRIORITY, };
+export { toolToCommand, commandToToolFn as commandToTool, canAccessTool, inferPermissionLevel, hasPermissionLevel, PERMISSION_LEVEL_PRIORITY, };
 //# sourceMappingURL=tool.d.ts.map