@zhin.js/core 1.0.24 → 1.0.26

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (211) hide show
  1. package/CHANGELOG.md +22 -0
  2. package/README.md +84 -342
  3. package/lib/adapter.d.ts +45 -1
  4. package/lib/adapter.d.ts.map +1 -1
  5. package/lib/adapter.js +182 -1
  6. package/lib/adapter.js.map +1 -1
  7. package/lib/ai/agent.d.ts +126 -0
  8. package/lib/ai/agent.d.ts.map +1 -0
  9. package/lib/ai/agent.js +645 -0
  10. package/lib/ai/agent.js.map +1 -0
  11. package/lib/ai/context-manager.d.ts +213 -0
  12. package/lib/ai/context-manager.d.ts.map +1 -0
  13. package/lib/ai/context-manager.js +313 -0
  14. package/lib/ai/context-manager.js.map +1 -0
  15. package/lib/ai/conversation-memory.d.ts +181 -0
  16. package/lib/ai/conversation-memory.d.ts.map +1 -0
  17. package/lib/ai/conversation-memory.js +581 -0
  18. package/lib/ai/conversation-memory.js.map +1 -0
  19. package/lib/ai/follow-up.d.ts +131 -0
  20. package/lib/ai/follow-up.d.ts.map +1 -0
  21. package/lib/ai/follow-up.js +265 -0
  22. package/lib/ai/follow-up.js.map +1 -0
  23. package/lib/ai/index.d.ts +29 -0
  24. package/lib/ai/index.d.ts.map +1 -0
  25. package/lib/ai/index.js +34 -0
  26. package/lib/ai/index.js.map +1 -0
  27. package/lib/ai/init.d.ts +30 -0
  28. package/lib/ai/init.d.ts.map +1 -0
  29. package/lib/ai/init.js +424 -0
  30. package/lib/ai/init.js.map +1 -0
  31. package/lib/ai/output.d.ts +93 -0
  32. package/lib/ai/output.d.ts.map +1 -0
  33. package/lib/ai/output.js +176 -0
  34. package/lib/ai/output.js.map +1 -0
  35. package/lib/ai/providers/anthropic.d.ts +23 -0
  36. package/lib/ai/providers/anthropic.d.ts.map +1 -0
  37. package/lib/ai/providers/anthropic.js +322 -0
  38. package/lib/ai/providers/anthropic.js.map +1 -0
  39. package/lib/ai/providers/base.d.ts +43 -0
  40. package/lib/ai/providers/base.d.ts.map +1 -0
  41. package/lib/ai/providers/base.js +135 -0
  42. package/lib/ai/providers/base.js.map +1 -0
  43. package/lib/ai/providers/index.d.ts +12 -0
  44. package/lib/ai/providers/index.d.ts.map +1 -0
  45. package/lib/ai/providers/index.js +9 -0
  46. package/lib/ai/providers/index.js.map +1 -0
  47. package/lib/ai/providers/ollama.d.ts +25 -0
  48. package/lib/ai/providers/ollama.d.ts.map +1 -0
  49. package/lib/ai/providers/ollama.js +243 -0
  50. package/lib/ai/providers/ollama.js.map +1 -0
  51. package/lib/ai/providers/openai.d.ts +46 -0
  52. package/lib/ai/providers/openai.d.ts.map +1 -0
  53. package/lib/ai/providers/openai.js +132 -0
  54. package/lib/ai/providers/openai.js.map +1 -0
  55. package/lib/ai/rate-limiter.d.ts +38 -0
  56. package/lib/ai/rate-limiter.d.ts.map +1 -0
  57. package/lib/ai/rate-limiter.js +86 -0
  58. package/lib/ai/rate-limiter.js.map +1 -0
  59. package/lib/ai/service.d.ts +81 -0
  60. package/lib/ai/service.d.ts.map +1 -0
  61. package/lib/ai/service.js +274 -0
  62. package/lib/ai/service.js.map +1 -0
  63. package/lib/ai/session.d.ts +186 -0
  64. package/lib/ai/session.d.ts.map +1 -0
  65. package/lib/ai/session.js +443 -0
  66. package/lib/ai/session.js.map +1 -0
  67. package/lib/ai/tone-detector.d.ts +19 -0
  68. package/lib/ai/tone-detector.d.ts.map +1 -0
  69. package/lib/ai/tone-detector.js +72 -0
  70. package/lib/ai/tone-detector.js.map +1 -0
  71. package/lib/ai/tools.d.ts +45 -0
  72. package/lib/ai/tools.d.ts.map +1 -0
  73. package/lib/ai/tools.js +206 -0
  74. package/lib/ai/tools.js.map +1 -0
  75. package/lib/ai/types.d.ts +264 -0
  76. package/lib/ai/types.d.ts.map +1 -0
  77. package/lib/ai/types.js +6 -0
  78. package/lib/ai/types.js.map +1 -0
  79. package/lib/ai/user-profile.d.ts +56 -0
  80. package/lib/ai/user-profile.d.ts.map +1 -0
  81. package/lib/ai/user-profile.js +130 -0
  82. package/lib/ai/user-profile.js.map +1 -0
  83. package/lib/ai/zhin-agent.d.ts +165 -0
  84. package/lib/ai/zhin-agent.d.ts.map +1 -0
  85. package/lib/ai/zhin-agent.js +707 -0
  86. package/lib/ai/zhin-agent.js.map +1 -0
  87. package/lib/built/adapter-process.d.ts +4 -0
  88. package/lib/built/adapter-process.d.ts.map +1 -1
  89. package/lib/built/adapter-process.js +94 -0
  90. package/lib/built/adapter-process.js.map +1 -1
  91. package/lib/built/ai-trigger.d.ts +89 -0
  92. package/lib/built/ai-trigger.d.ts.map +1 -0
  93. package/lib/built/ai-trigger.js +166 -0
  94. package/lib/built/ai-trigger.js.map +1 -0
  95. package/lib/built/command.d.ts +33 -17
  96. package/lib/built/command.d.ts.map +1 -1
  97. package/lib/built/command.js +71 -44
  98. package/lib/built/command.js.map +1 -1
  99. package/lib/built/component.d.ts +42 -15
  100. package/lib/built/component.d.ts.map +1 -1
  101. package/lib/built/component.js +84 -52
  102. package/lib/built/component.js.map +1 -1
  103. package/lib/built/config.d.ts +54 -5
  104. package/lib/built/config.d.ts.map +1 -1
  105. package/lib/built/config.js +76 -10
  106. package/lib/built/config.js.map +1 -1
  107. package/lib/built/cron.d.ts +41 -18
  108. package/lib/built/cron.d.ts.map +1 -1
  109. package/lib/built/cron.js +106 -63
  110. package/lib/built/cron.js.map +1 -1
  111. package/lib/built/database.d.ts +55 -6
  112. package/lib/built/database.d.ts.map +1 -1
  113. package/lib/built/database.js +93 -22
  114. package/lib/built/database.js.map +1 -1
  115. package/lib/built/dispatcher.d.ts +118 -0
  116. package/lib/built/dispatcher.d.ts.map +1 -0
  117. package/lib/built/dispatcher.js +196 -0
  118. package/lib/built/dispatcher.js.map +1 -0
  119. package/lib/built/permission.d.ts +45 -5
  120. package/lib/built/permission.d.ts.map +1 -1
  121. package/lib/built/permission.js +56 -11
  122. package/lib/built/permission.js.map +1 -1
  123. package/lib/built/skill.d.ts +117 -0
  124. package/lib/built/skill.d.ts.map +1 -0
  125. package/lib/built/skill.js +191 -0
  126. package/lib/built/skill.js.map +1 -0
  127. package/lib/built/tool.d.ts +188 -0
  128. package/lib/built/tool.d.ts.map +1 -0
  129. package/lib/built/tool.js +749 -0
  130. package/lib/built/tool.js.map +1 -0
  131. package/lib/feature.d.ts +75 -0
  132. package/lib/feature.d.ts.map +1 -0
  133. package/lib/feature.js +69 -0
  134. package/lib/feature.js.map +1 -0
  135. package/lib/index.d.ts +6 -0
  136. package/lib/index.d.ts.map +1 -1
  137. package/lib/index.js +11 -0
  138. package/lib/index.js.map +1 -1
  139. package/lib/plugin.d.ts +53 -18
  140. package/lib/plugin.d.ts.map +1 -1
  141. package/lib/plugin.js +301 -31
  142. package/lib/plugin.js.map +1 -1
  143. package/lib/types.d.ts +248 -9
  144. package/lib/types.d.ts.map +1 -1
  145. package/lib/utils.d.ts.map +1 -1
  146. package/lib/utils.js +38 -12
  147. package/lib/utils.js.map +1 -1
  148. package/package.json +4 -4
  149. package/src/adapter.ts +206 -2
  150. package/src/ai/agent.ts +772 -0
  151. package/src/ai/context-manager.ts +440 -0
  152. package/src/ai/conversation-memory.ts +774 -0
  153. package/src/ai/follow-up.ts +357 -0
  154. package/src/ai/index.ts +128 -0
  155. package/src/ai/init.ts +502 -0
  156. package/src/ai/output.ts +261 -0
  157. package/src/ai/providers/anthropic.ts +375 -0
  158. package/src/ai/providers/base.ts +173 -0
  159. package/src/ai/providers/index.ts +13 -0
  160. package/src/ai/providers/ollama.ts +292 -0
  161. package/src/ai/providers/openai.ts +167 -0
  162. package/src/ai/rate-limiter.ts +129 -0
  163. package/src/ai/service.ts +319 -0
  164. package/src/ai/session.ts +544 -0
  165. package/src/ai/tone-detector.ts +89 -0
  166. package/src/ai/tools.ts +218 -0
  167. package/src/ai/types.ts +296 -0
  168. package/src/ai/user-profile.ts +181 -0
  169. package/src/ai/zhin-agent.ts +845 -0
  170. package/src/built/adapter-process.ts +99 -0
  171. package/src/built/ai-trigger.ts +259 -0
  172. package/src/built/command.ts +75 -69
  173. package/src/built/component.ts +94 -76
  174. package/src/built/config.ts +238 -128
  175. package/src/built/cron.ts +117 -101
  176. package/src/built/database.ts +128 -33
  177. package/src/built/dispatcher.ts +332 -0
  178. package/src/built/permission.ts +146 -54
  179. package/src/built/skill.ts +280 -0
  180. package/src/built/tool.ts +928 -0
  181. package/src/feature.ts +113 -0
  182. package/src/index.ts +11 -0
  183. package/src/plugin.ts +359 -69
  184. package/src/types.ts +306 -11
  185. package/src/utils.ts +37 -13
  186. package/tests/adapter.test.ts +153 -1
  187. package/tests/ai/agent.test.ts +614 -0
  188. package/tests/ai/ai-trigger.test.ts +368 -0
  189. package/tests/ai/context-manager.test.ts +413 -0
  190. package/tests/ai/conversation-memory.test.ts +128 -0
  191. package/tests/ai/follow-up.test.ts +175 -0
  192. package/tests/ai/integration.test.ts +584 -0
  193. package/tests/ai/output.test.ts +128 -0
  194. package/tests/ai/providers.integration.test.ts +227 -0
  195. package/tests/ai/rate-limiter.test.ts +108 -0
  196. package/tests/ai/session.test.ts +375 -0
  197. package/tests/ai/setup.ts +308 -0
  198. package/tests/ai/tone-detector.test.ts +80 -0
  199. package/tests/ai/tool.test.ts +800 -0
  200. package/tests/ai/tools-builtin.test.ts +346 -0
  201. package/tests/ai/user-profile.test.ts +73 -0
  202. package/tests/ai/zhin-agent.test.ts +177 -0
  203. package/tests/component-new.test.ts +17 -6
  204. package/tests/config.test.ts +46 -0
  205. package/tests/cron.test.ts +94 -5
  206. package/tests/dispatcher.test.ts +146 -0
  207. package/tests/feature.test.ts +145 -0
  208. package/tests/features-builtin.test.ts +191 -0
  209. package/tests/plugin.test.ts +88 -14
  210. package/tests/skill-feature.test.ts +179 -0
  211. package/tests/tool-feature.test.ts +254 -0
@@ -0,0 +1,191 @@
1
+ /**
2
+ * SkillFeature — AI 可见能力描述层
3
+ *
4
+ * 核心概念:
5
+ * Plugin = 运行时容器(生命周期、服务注册、中间件)
6
+ * Skill = AI 可见的能力接口(名称、描述、工具列表)
7
+ *
8
+ * 每个 Plugin 可以声明一个 Skill 描述,告诉 AI Agent:
9
+ * "我叫什么、我能做什么、我有哪些工具"
10
+ *
11
+ * SkillFeature 全局收集所有 Skill,供 Agent 进行两级过滤:
12
+ * 1. 粗筛:根据用户消息选择相关 Skill
13
+ * 2. 细筛:从选中 Skill 内选择具体 Tool
14
+ */
15
+ import { Feature } from '../feature.js';
16
+ import { getPlugin } from '../plugin.js';
17
+ // ============================================================================
18
+ // SkillFeature 实现
19
+ // ============================================================================
20
+ export class SkillFeature extends Feature {
21
+ name = 'skill';
22
+ icon = 'Brain';
23
+ desc = '技能';
24
+ /** 按名称索引 */
25
+ byName = new Map();
26
+ /**
27
+ * 添加 Skill
28
+ */
29
+ add(skill, pluginName) {
30
+ this.byName.set(skill.name, skill);
31
+ return super.add(skill, pluginName);
32
+ }
33
+ /**
34
+ * 移除 Skill
35
+ */
36
+ remove(skill) {
37
+ this.byName.delete(skill.name);
38
+ return super.remove(skill);
39
+ }
40
+ /**
41
+ * 按名称获取 Skill
42
+ */
43
+ get(name) {
44
+ return this.byName.get(name);
45
+ }
46
+ /**
47
+ * 获取所有已注册 Skill
48
+ */
49
+ getAll() {
50
+ return [...this.items];
51
+ }
52
+ /**
53
+ * 按关键词/标签搜索相关 Skill
54
+ * 返回按相关性排序的 Skill 列表
55
+ */
56
+ search(query, options) {
57
+ const maxResults = options?.maxResults ?? 5;
58
+ const scored = this.items
59
+ .map(skill => ({ skill, score: this.#scoreSkill(skill, query) }))
60
+ .filter(({ score }) => score > 0)
61
+ .sort((a, b) => b.score - a.score)
62
+ .slice(0, maxResults);
63
+ return scored.map(({ skill }) => skill);
64
+ }
65
+ /**
66
+ * 获取所有 Skill 的工具(扁平化)
67
+ */
68
+ collectAllTools() {
69
+ const tools = [];
70
+ for (const skill of this.items) {
71
+ tools.push(...skill.tools);
72
+ }
73
+ return tools;
74
+ }
75
+ /**
76
+ * 已注册 Skill 数量
77
+ */
78
+ get size() {
79
+ return this.items.length;
80
+ }
81
+ /**
82
+ * 简单的关键词匹配评分
83
+ */
84
+ #scoreSkill(skill, query) {
85
+ const lowerQuery = query.toLowerCase();
86
+ let score = 0;
87
+ // 关键词精确匹配
88
+ if (skill.keywords) {
89
+ for (const kw of skill.keywords) {
90
+ if (lowerQuery.includes(kw.toLowerCase()))
91
+ score += 1.0;
92
+ }
93
+ }
94
+ // 标签匹配
95
+ if (skill.tags) {
96
+ for (const tag of skill.tags) {
97
+ if (lowerQuery.includes(tag.toLowerCase()))
98
+ score += 0.5;
99
+ }
100
+ }
101
+ // 名称匹配
102
+ if (lowerQuery.includes(skill.name.toLowerCase()))
103
+ score += 0.3;
104
+ // 描述匹配(双向)
105
+ const lowerDesc = skill.description.toLowerCase();
106
+ if (lowerDesc.includes(lowerQuery))
107
+ score += 0.2;
108
+ if (lowerQuery.includes(lowerDesc))
109
+ score += 0.15;
110
+ // 工具名/描述匹配
111
+ for (const tool of skill.tools) {
112
+ if (lowerQuery.includes(tool.name.toLowerCase()))
113
+ score += 0.4;
114
+ if (tool.description && lowerQuery.includes(tool.description.toLowerCase().slice(0, 10))) {
115
+ score += 0.1;
116
+ }
117
+ }
118
+ return score;
119
+ }
120
+ /**
121
+ * 序列化为 JSON
122
+ */
123
+ toJSON(pluginName) {
124
+ const list = pluginName ? this.getByPlugin(pluginName) : this.items;
125
+ return {
126
+ name: this.name,
127
+ icon: this.icon,
128
+ desc: this.desc,
129
+ count: list.length,
130
+ items: list.map(s => ({
131
+ name: s.name,
132
+ desc: s.description,
133
+ toolCount: s.tools.length,
134
+ keywords: s.keywords,
135
+ tags: s.tags,
136
+ })),
137
+ };
138
+ }
139
+ /**
140
+ * 提供给 Plugin.prototype 的扩展方法
141
+ */
142
+ get extensions() {
143
+ const feature = this;
144
+ return {
145
+ declareSkill(metadata) {
146
+ const plugin = getPlugin();
147
+ const pluginName = plugin.name;
148
+ // 收集该插件注册的工具
149
+ const toolService = plugin.root.inject('tool');
150
+ let tools = [];
151
+ if (toolService && typeof toolService.getToolsByPlugin === 'function') {
152
+ tools = toolService.getToolsByPlugin(pluginName);
153
+ }
154
+ else {
155
+ // 回退:从插件本地工具获取
156
+ tools = plugin.getAllTools?.() || [];
157
+ }
158
+ // 聚合关键词:开发者声明 + 工具自带
159
+ const allKeywords = new Set(metadata.keywords || []);
160
+ for (const tool of tools) {
161
+ if (tool.keywords) {
162
+ for (const kw of tool.keywords) {
163
+ allKeywords.add(kw);
164
+ }
165
+ }
166
+ }
167
+ // 聚合标签
168
+ const allTags = new Set(metadata.tags || []);
169
+ for (const tool of tools) {
170
+ if (tool.tags) {
171
+ for (const tag of tool.tags) {
172
+ allTags.add(tag);
173
+ }
174
+ }
175
+ }
176
+ const skill = {
177
+ name: pluginName,
178
+ description: metadata.description,
179
+ tools,
180
+ keywords: Array.from(allKeywords),
181
+ tags: Array.from(allTags),
182
+ pluginName,
183
+ };
184
+ const dispose = feature.add(skill, pluginName);
185
+ plugin.recordFeatureContribution(feature.name, pluginName);
186
+ plugin.onDispose(dispose);
187
+ },
188
+ };
189
+ }
190
+ }
191
+ //# sourceMappingURL=skill.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"skill.js","sourceRoot":"","sources":["../../src/built/skill.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,188 @@
1
+ /**
2
+ * ToolFeature — 统一的工具管理服务
3
+ * 支持 Tool ↔ Command 互转
4
+ */
5
+ import { Feature, FeatureJSON } from "../feature.js";
6
+ import { MessageCommand } from "../command.js";
7
+ import { Plugin } from "../plugin.js";
8
+ import type { Tool, ToolDefinition, RegisteredAdapter, ToolContext, ToolJsonSchema, ToolParametersSchema, PropertySchema, MaybePromise, ToolPermissionLevel, ToolScope } from "../types.js";
9
+ /**
10
+ * 权限级别优先级(数字越大权限越高)
11
+ */
12
+ declare const PERMISSION_LEVEL_PRIORITY: Record<ToolPermissionLevel, number>;
13
+ /**
14
+ * 比较两个权限级别
15
+ * @returns 如果 a >= b 返回 true
16
+ */
17
+ declare function hasPermissionLevel(userLevel: ToolPermissionLevel, requiredLevel: ToolPermissionLevel): boolean;
18
+ /**
19
+ * 从 ToolContext 推断用户的权限级别
20
+ */
21
+ declare function inferPermissionLevel(context: ToolContext): ToolPermissionLevel;
22
+ /**
23
+ * 检查工具是否可被当前上下文访问
24
+ */
25
+ declare function canAccessTool(tool: Tool, context: ToolContext): boolean;
26
+ /**
27
+ * 从 Tool 参数生成命令模式
28
+ * @example
29
+ * parameters: { properties: { city: { type: 'string' } }, required: ['city'] }
30
+ * => 'toolName <city>'
31
+ */
32
+ export declare function generatePattern(tool: Tool): string;
33
+ /**
34
+ * 从参数定义中提取参数信息
35
+ */
36
+ export declare function extractParamInfo(parameters: ToolJsonSchema): Tool.ParamInfo[];
37
+ /**
38
+ * 定义工具的辅助函数(提供类型推断)
39
+ */
40
+ export declare function defineTool<TArgs extends Record<string, any> = Record<string, any>>(tool: ToolDefinition<TArgs>): Tool;
41
+ /**
42
+ * 参数定义(带顺序)
43
+ */
44
+ interface ParamDef {
45
+ name: string;
46
+ schema: PropertySchema;
47
+ required: boolean;
48
+ }
49
+ /**
50
+ * ZhinTool 类
51
+ * 提供类似 MessageCommand 的链式调用风格来定义工具
52
+ */
53
+ export declare class ZhinTool {
54
+ #private;
55
+ constructor(name: string);
56
+ get name(): string;
57
+ get description(): string;
58
+ get params(): ParamDef[];
59
+ desc(description: string): this;
60
+ param(name: string, schema: PropertySchema, required?: boolean): this;
61
+ platform(...platforms: string[]): this;
62
+ scope(...scopes: ToolScope[]): this;
63
+ permission(level: ToolPermissionLevel): this;
64
+ permit(...permissions: string[]): this;
65
+ tag(...tags: string[]): this;
66
+ keyword(...keywords: string[]): this;
67
+ hidden(value?: boolean): this;
68
+ usage(...usage: string[]): this;
69
+ examples(...examples: string[]): this;
70
+ alias(...alias: string[]): this;
71
+ pattern(pattern: string): this;
72
+ execute(callback: (args: Record<string, any>, context?: ToolContext) => MaybePromise<any>): this;
73
+ action(callback: MessageCommand.Callback<RegisteredAdapter>): this;
74
+ toTool(): Tool;
75
+ getActionCallback(): MessageCommand.Callback<RegisteredAdapter> | undefined;
76
+ toJSON(): {
77
+ name: string;
78
+ description: string;
79
+ parameters: ToolParametersSchema;
80
+ platforms?: string[];
81
+ scopes?: ToolScope[];
82
+ permissionLevel?: ToolPermissionLevel;
83
+ tags?: string[];
84
+ };
85
+ get help(): string;
86
+ toString(): string;
87
+ }
88
+ export declare function isZhinTool(obj: any): obj is ZhinTool;
89
+ /**
90
+ * 工具输入类型(支持 Tool 对象或 ZhinTool 实例)
91
+ */
92
+ export type ToolInput = Tool | ZhinTool;
93
+ /**
94
+ * ToolContext 扩展方法类型
95
+ */
96
+ export interface ToolContextExtensions {
97
+ /** 添加工具(自动生成命令) */
98
+ addTool(tool: ToolInput): () => void;
99
+ /** 仅添加工具,不生成命令 */
100
+ addToolOnly(tool: ToolInput): () => void;
101
+ }
102
+ declare module "../plugin.js" {
103
+ namespace Plugin {
104
+ interface Extensions extends ToolContextExtensions {
105
+ }
106
+ interface Contexts {
107
+ tool: ToolFeature;
108
+ }
109
+ }
110
+ }
111
+ /**
112
+ * 将 Tool 转换为 MessageCommand
113
+ */
114
+ declare function toolToCommand(tool: Tool): MessageCommand<RegisteredAdapter>;
115
+ /**
116
+ * 将 MessageCommand 转换为 Tool
117
+ */
118
+ declare function commandToToolFn(command: MessageCommand<RegisteredAdapter>, pluginName: string): Tool;
119
+ export declare class ToolFeature extends Feature<Tool> {
120
+ #private;
121
+ readonly name: "tool";
122
+ readonly icon = "Wrench";
123
+ readonly desc = "\u5DE5\u5177";
124
+ /** 按名称索引 */
125
+ readonly byName: Map<string, Tool>;
126
+ /** 工具对应的命令 */
127
+ readonly toolCommands: Map<string, MessageCommand<"process">>;
128
+ /**
129
+ * 添加工具
130
+ * @param toolInput 工具或 ZhinTool 实例
131
+ * @param pluginName 注册插件名
132
+ * @param generateCommand 是否生成命令(默认 true)
133
+ */
134
+ addTool(toolInput: ToolInput, pluginName: string, generateCommand?: boolean): () => void;
135
+ /**
136
+ * 移除工具
137
+ */
138
+ removeTool(name: string): boolean;
139
+ /**
140
+ * 获取工具
141
+ */
142
+ get(name: string): Tool | undefined;
143
+ /**
144
+ * 获取所有工具
145
+ */
146
+ getAll(): Tool[];
147
+ /**
148
+ * 根据标签过滤工具
149
+ */
150
+ getByTags(tags: string[]): Tool[];
151
+ /**
152
+ * 执行工具
153
+ */
154
+ execute(name: string, args: Record<string, any>, context?: ToolContext): Promise<any>;
155
+ /**
156
+ * 将 Command 转换为 Tool
157
+ */
158
+ commandToTool(command: MessageCommand<RegisteredAdapter>, pluginName: string): Tool;
159
+ /**
160
+ * 收集所有可用工具(包括从 Command 转换的)
161
+ */
162
+ collectAll(plugin: Plugin): Tool[];
163
+ /**
164
+ * 根据上下文过滤工具
165
+ */
166
+ filterByContext(tools: Tool[], context: ToolContext): Tool[];
167
+ /**
168
+ * 按插件名获取工具
169
+ */
170
+ getToolsByPlugin(pluginName: string): Tool[];
171
+ /**
172
+ * 兼容旧接口:tools Map
173
+ */
174
+ get tools(): Map<string, Tool>;
175
+ /**
176
+ * 序列化为 JSON
177
+ */
178
+ toJSON(pluginName?: string): FeatureJSON;
179
+ /**
180
+ * 提供给 Plugin.prototype 的扩展方法
181
+ */
182
+ get extensions(): {
183
+ addTool(tool: ToolInput): () => void;
184
+ addToolOnly(tool: ToolInput): () => void;
185
+ };
186
+ }
187
+ export { toolToCommand, commandToToolFn as commandToTool, canAccessTool, inferPermissionLevel, hasPermissionLevel, PERMISSION_LEVEL_PRIORITY, };
188
+ //# sourceMappingURL=tool.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/built/tool.ts"],"names":[],"mappings":"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"}