@zhin.js/core 1.0.36 → 1.0.38

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 (196) hide show
  1. package/CHANGELOG.md +18 -0
  2. package/README.md +57 -3
  3. package/lib/adapter.d.ts +11 -0
  4. package/lib/adapter.d.ts.map +1 -1
  5. package/lib/adapter.js +61 -0
  6. package/lib/adapter.js.map +1 -1
  7. package/lib/ai/index.d.ts +3 -39
  8. package/lib/ai/index.d.ts.map +1 -1
  9. package/lib/ai/index.js +2 -44
  10. package/lib/ai/index.js.map +1 -1
  11. package/lib/ai/types.d.ts +4 -3
  12. package/lib/ai/types.d.ts.map +1 -1
  13. package/lib/built/ai-trigger.js.map +1 -1
  14. package/lib/built/common-adapter-tools.d.ts +55 -0
  15. package/lib/built/common-adapter-tools.d.ts.map +1 -0
  16. package/lib/built/common-adapter-tools.js +158 -0
  17. package/lib/built/common-adapter-tools.js.map +1 -0
  18. package/lib/built/dispatcher.d.ts.map +1 -1
  19. package/lib/built/dispatcher.js +50 -46
  20. package/lib/built/dispatcher.js.map +1 -1
  21. package/lib/built/skill.d.ts.map +1 -1
  22. package/lib/built/skill.js +0 -1
  23. package/lib/built/skill.js.map +1 -1
  24. package/lib/built/tool.d.ts +3 -3
  25. package/lib/built/tool.d.ts.map +1 -1
  26. package/lib/built/tool.js.map +1 -1
  27. package/lib/feature.d.ts +16 -1
  28. package/lib/feature.d.ts.map +1 -1
  29. package/lib/feature.js +41 -2
  30. package/lib/feature.js.map +1 -1
  31. package/lib/index.d.ts +1 -0
  32. package/lib/index.d.ts.map +1 -1
  33. package/lib/index.js +2 -0
  34. package/lib/index.js.map +1 -1
  35. package/lib/plugin.d.ts +38 -1
  36. package/lib/plugin.d.ts.map +1 -1
  37. package/lib/plugin.js +73 -22
  38. package/lib/plugin.js.map +1 -1
  39. package/lib/scheduler/scheduler.js +1 -1
  40. package/lib/scheduler/scheduler.js.map +1 -1
  41. package/lib/types.d.ts +43 -28
  42. package/lib/types.d.ts.map +1 -1
  43. package/lib/utils.d.ts +12 -3
  44. package/lib/utils.d.ts.map +1 -1
  45. package/lib/utils.js +64 -54
  46. package/lib/utils.js.map +1 -1
  47. package/package.json +5 -5
  48. package/src/adapter.ts +85 -5
  49. package/src/ai/index.ts +8 -186
  50. package/src/ai/types.ts +5 -4
  51. package/src/built/ai-trigger.ts +2 -2
  52. package/src/built/common-adapter-tools.ts +207 -0
  53. package/src/built/dispatcher.ts +51 -52
  54. package/src/built/skill.ts +3 -4
  55. package/src/built/tool.ts +3 -3
  56. package/src/feature.ts +45 -2
  57. package/src/index.ts +2 -0
  58. package/src/plugin.ts +92 -31
  59. package/src/scheduler/scheduler.ts +1 -1
  60. package/src/types.ts +39 -28
  61. package/src/utils.ts +63 -52
  62. package/tests/ai/setup.ts +2 -2
  63. package/tests/utils.test.ts +1 -3
  64. package/lib/ai/agent.d.ts +0 -130
  65. package/lib/ai/agent.d.ts.map +0 -1
  66. package/lib/ai/agent.js +0 -684
  67. package/lib/ai/agent.js.map +0 -1
  68. package/lib/ai/bootstrap.d.ts +0 -91
  69. package/lib/ai/bootstrap.d.ts.map +0 -1
  70. package/lib/ai/bootstrap.js +0 -243
  71. package/lib/ai/bootstrap.js.map +0 -1
  72. package/lib/ai/builtin-tools.d.ts +0 -59
  73. package/lib/ai/builtin-tools.d.ts.map +0 -1
  74. package/lib/ai/builtin-tools.js +0 -777
  75. package/lib/ai/builtin-tools.js.map +0 -1
  76. package/lib/ai/compaction.d.ts +0 -132
  77. package/lib/ai/compaction.d.ts.map +0 -1
  78. package/lib/ai/compaction.js +0 -370
  79. package/lib/ai/compaction.js.map +0 -1
  80. package/lib/ai/context-manager.d.ts +0 -213
  81. package/lib/ai/context-manager.d.ts.map +0 -1
  82. package/lib/ai/context-manager.js +0 -313
  83. package/lib/ai/context-manager.js.map +0 -1
  84. package/lib/ai/conversation-memory.d.ts +0 -181
  85. package/lib/ai/conversation-memory.d.ts.map +0 -1
  86. package/lib/ai/conversation-memory.js +0 -581
  87. package/lib/ai/conversation-memory.js.map +0 -1
  88. package/lib/ai/cron-engine.d.ts +0 -92
  89. package/lib/ai/cron-engine.d.ts.map +0 -1
  90. package/lib/ai/cron-engine.js +0 -278
  91. package/lib/ai/cron-engine.js.map +0 -1
  92. package/lib/ai/follow-up.d.ts +0 -131
  93. package/lib/ai/follow-up.d.ts.map +0 -1
  94. package/lib/ai/follow-up.js +0 -265
  95. package/lib/ai/follow-up.js.map +0 -1
  96. package/lib/ai/hooks.d.ts +0 -143
  97. package/lib/ai/hooks.d.ts.map +0 -1
  98. package/lib/ai/hooks.js +0 -108
  99. package/lib/ai/hooks.js.map +0 -1
  100. package/lib/ai/init.d.ts +0 -30
  101. package/lib/ai/init.d.ts.map +0 -1
  102. package/lib/ai/init.js +0 -686
  103. package/lib/ai/init.js.map +0 -1
  104. package/lib/ai/output.d.ts +0 -93
  105. package/lib/ai/output.d.ts.map +0 -1
  106. package/lib/ai/output.js +0 -176
  107. package/lib/ai/output.js.map +0 -1
  108. package/lib/ai/rate-limiter.d.ts +0 -38
  109. package/lib/ai/rate-limiter.d.ts.map +0 -1
  110. package/lib/ai/rate-limiter.js +0 -86
  111. package/lib/ai/rate-limiter.js.map +0 -1
  112. package/lib/ai/service.d.ts +0 -88
  113. package/lib/ai/service.d.ts.map +0 -1
  114. package/lib/ai/service.js +0 -285
  115. package/lib/ai/service.js.map +0 -1
  116. package/lib/ai/session.d.ts +0 -186
  117. package/lib/ai/session.d.ts.map +0 -1
  118. package/lib/ai/session.js +0 -443
  119. package/lib/ai/session.js.map +0 -1
  120. package/lib/ai/subagent.d.ts +0 -50
  121. package/lib/ai/subagent.d.ts.map +0 -1
  122. package/lib/ai/subagent.js +0 -144
  123. package/lib/ai/subagent.js.map +0 -1
  124. package/lib/ai/tone-detector.d.ts +0 -19
  125. package/lib/ai/tone-detector.d.ts.map +0 -1
  126. package/lib/ai/tone-detector.js +0 -72
  127. package/lib/ai/tone-detector.js.map +0 -1
  128. package/lib/ai/tools.d.ts +0 -45
  129. package/lib/ai/tools.d.ts.map +0 -1
  130. package/lib/ai/tools.js +0 -206
  131. package/lib/ai/tools.js.map +0 -1
  132. package/lib/ai/user-profile.d.ts +0 -56
  133. package/lib/ai/user-profile.d.ts.map +0 -1
  134. package/lib/ai/user-profile.js +0 -130
  135. package/lib/ai/user-profile.js.map +0 -1
  136. package/lib/ai/zhin-agent/builtin-tools.d.ts +0 -17
  137. package/lib/ai/zhin-agent/builtin-tools.d.ts.map +0 -1
  138. package/lib/ai/zhin-agent/builtin-tools.js +0 -220
  139. package/lib/ai/zhin-agent/builtin-tools.js.map +0 -1
  140. package/lib/ai/zhin-agent/config.d.ts +0 -54
  141. package/lib/ai/zhin-agent/config.d.ts.map +0 -1
  142. package/lib/ai/zhin-agent/config.js +0 -76
  143. package/lib/ai/zhin-agent/config.js.map +0 -1
  144. package/lib/ai/zhin-agent/exec-policy.d.ts +0 -20
  145. package/lib/ai/zhin-agent/exec-policy.d.ts.map +0 -1
  146. package/lib/ai/zhin-agent/exec-policy.js +0 -71
  147. package/lib/ai/zhin-agent/exec-policy.js.map +0 -1
  148. package/lib/ai/zhin-agent/index.d.ts +0 -70
  149. package/lib/ai/zhin-agent/index.d.ts.map +0 -1
  150. package/lib/ai/zhin-agent/index.js +0 -404
  151. package/lib/ai/zhin-agent/index.js.map +0 -1
  152. package/lib/ai/zhin-agent/prompt.d.ts +0 -21
  153. package/lib/ai/zhin-agent/prompt.d.ts.map +0 -1
  154. package/lib/ai/zhin-agent/prompt.js +0 -111
  155. package/lib/ai/zhin-agent/prompt.js.map +0 -1
  156. package/lib/ai/zhin-agent/tool-collector.d.ts +0 -22
  157. package/lib/ai/zhin-agent/tool-collector.d.ts.map +0 -1
  158. package/lib/ai/zhin-agent/tool-collector.js +0 -218
  159. package/lib/ai/zhin-agent/tool-collector.js.map +0 -1
  160. package/src/ai/agent.ts +0 -812
  161. package/src/ai/bootstrap.ts +0 -309
  162. package/src/ai/builtin-tools.ts +0 -849
  163. package/src/ai/compaction.ts +0 -529
  164. package/src/ai/context-manager.ts +0 -440
  165. package/src/ai/conversation-memory.ts +0 -774
  166. package/src/ai/cron-engine.ts +0 -337
  167. package/src/ai/follow-up.ts +0 -357
  168. package/src/ai/hooks.ts +0 -223
  169. package/src/ai/init.ts +0 -762
  170. package/src/ai/output.ts +0 -261
  171. package/src/ai/rate-limiter.ts +0 -129
  172. package/src/ai/service.ts +0 -331
  173. package/src/ai/session.ts +0 -544
  174. package/src/ai/subagent.ts +0 -209
  175. package/src/ai/tone-detector.ts +0 -89
  176. package/src/ai/tools.ts +0 -218
  177. package/src/ai/user-profile.ts +0 -181
  178. package/src/ai/zhin-agent/builtin-tools.ts +0 -247
  179. package/src/ai/zhin-agent/config.ts +0 -113
  180. package/src/ai/zhin-agent/exec-policy.ts +0 -78
  181. package/src/ai/zhin-agent/index.ts +0 -512
  182. package/src/ai/zhin-agent/prompt.ts +0 -131
  183. package/src/ai/zhin-agent/tool-collector.ts +0 -243
  184. package/tests/ai/agent.test.ts +0 -614
  185. package/tests/ai/context-manager.test.ts +0 -413
  186. package/tests/ai/conversation-memory.test.ts +0 -128
  187. package/tests/ai/follow-up.test.ts +0 -175
  188. package/tests/ai/integration.test.ts +0 -584
  189. package/tests/ai/output.test.ts +0 -128
  190. package/tests/ai/rate-limiter.test.ts +0 -108
  191. package/tests/ai/session.test.ts +0 -375
  192. package/tests/ai/subagent.test.ts +0 -270
  193. package/tests/ai/tone-detector.test.ts +0 -80
  194. package/tests/ai/tools-builtin.test.ts +0 -346
  195. package/tests/ai/user-profile.test.ts +0 -73
  196. package/tests/ai/zhin-agent.test.ts +0 -177
package/src/ai/service.ts DELETED
@@ -1,331 +0,0 @@
1
- /**
2
- * AIService — AI 服务核心类
3
- * 统一管理多个模型提供商,提供会话和 Agent 能力
4
- */
5
-
6
- import { Logger } from '@zhin.js/logger';
7
- import type { Plugin } from '../plugin.js';
8
- import type { Tool, ToolContext } from '../types.js';
9
- import type { AITriggerConfig } from '../built/ai-trigger.js';
10
- import type {
11
- AIProvider,
12
- AIConfig,
13
- ChatMessage,
14
- ChatCompletionRequest,
15
- ChatCompletionResponse,
16
- ChatCompletionChunk,
17
- AgentTool,
18
- } from './types.js';
19
- import {
20
- OpenAIProvider,
21
- DeepSeekProvider,
22
- MoonshotProvider,
23
- ZhipuProvider,
24
- AnthropicProvider,
25
- OllamaProvider,
26
- } from './providers/index.js';
27
- import {
28
- SessionManager,
29
- createMemorySessionManager,
30
- createDatabaseSessionManager,
31
- } from './session.js';
32
- import { Agent, createAgent } from './agent.js';
33
- import { getBuiltinTools } from './tools.js';
34
- import type { ContextManager, ContextConfig } from './context-manager.js';
35
-
36
- const aiLogger = new Logger(null, 'AI');
37
-
38
- export class AIService {
39
- private providers: Map<string, AIProvider> = new Map();
40
- private defaultProvider: string;
41
- public sessions: SessionManager;
42
- public contextManager?: ContextManager;
43
- private builtinTools: AgentTool[];
44
- private sessionConfig: { maxHistory?: number; expireMs?: number };
45
- private contextConfig: ContextConfig;
46
- private triggerConfig: AITriggerConfig;
47
- private agentConfig: AIConfig['agent'];
48
- private plugin?: Plugin;
49
- private customTools: Map<string, AgentTool> = new Map();
50
-
51
- constructor(config: AIConfig = {}) {
52
- this.defaultProvider = config.defaultProvider || 'openai';
53
- this.sessionConfig = config.sessions || {};
54
- this.contextConfig = config.context || {};
55
- this.triggerConfig = config.trigger || {};
56
- this.agentConfig = config.agent;
57
- this.sessions = createMemorySessionManager(this.sessionConfig);
58
- this.builtinTools = getBuiltinTools().map(tool => this.convertToolToAgentTool(tool.toTool()));
59
-
60
- if (config.providers?.openai?.apiKey) {
61
- this.registerProvider(new OpenAIProvider(config.providers.openai));
62
- }
63
- if (config.providers?.anthropic?.apiKey) {
64
- this.registerProvider(new AnthropicProvider(config.providers.anthropic));
65
- }
66
- if (config.providers?.deepseek?.apiKey) {
67
- this.registerProvider(new DeepSeekProvider(config.providers.deepseek));
68
- }
69
- if (config.providers?.moonshot?.apiKey) {
70
- this.registerProvider(new MoonshotProvider(config.providers.moonshot));
71
- }
72
- if (config.providers?.zhipu?.apiKey) {
73
- this.registerProvider(new ZhipuProvider(config.providers.zhipu));
74
- }
75
- if (config.providers?.ollama) {
76
- this.registerProvider(new OllamaProvider(config.providers.ollama));
77
- }
78
- }
79
-
80
- isReady(): boolean {
81
- return this.providers.size > 0;
82
- }
83
-
84
- private static readonly PRE_EXEC_TIMEOUT = 10_000;
85
-
86
- async process(
87
- content: string,
88
- context: ToolContext,
89
- tools: Tool[],
90
- ): Promise<string | AsyncIterable<string>> {
91
- const { platform, senderId, sceneId } = context;
92
- const sessionId = SessionManager.generateId(platform || '', senderId || '', sceneId);
93
- const allTools = this.collectAllToolsWithExternal(tools);
94
- const baseSystemPrompt = '你是一个友好的中文 AI 助手,请始终使用中文回复。';
95
-
96
- if (allTools.length === 0) {
97
- return this.finishAndSave(sessionId, content, baseSystemPrompt, sceneId);
98
- }
99
-
100
- const callerPermissionLevel = context.senderPermissionLevel
101
- ? (AIService.PERM_MAP[context.senderPermissionLevel] ?? 0)
102
- : (context.isOwner ? 4 : context.isBotAdmin ? 3 : context.isGroupOwner ? 2 : context.isGroupAdmin ? 1 : 0);
103
-
104
- const relevantTools = Agent.filterTools(content, allTools, {
105
- callerPermissionLevel,
106
- maxTools: 8,
107
- minScore: 0.1,
108
- });
109
-
110
- if (relevantTools.length === 0) {
111
- return this.finishAndSave(sessionId, content, baseSystemPrompt, sceneId);
112
- }
113
-
114
- const noParamTools: AgentTool[] = [];
115
- const paramTools: AgentTool[] = [];
116
- for (const tool of relevantTools) {
117
- const required = tool.parameters?.required;
118
- (!required || required.length === 0) ? noParamTools.push(tool) : paramTools.push(tool);
119
- }
120
-
121
- let preExecutedData = '';
122
- const preExecutedCalls: { tool: string; args: Record<string, any>; result: any }[] = [];
123
-
124
- if (noParamTools.length > 0) {
125
- const results = await Promise.allSettled(
126
- noParamTools.map(async (tool) => {
127
- const result = await Promise.race([
128
- tool.execute({}),
129
- new Promise<never>((_, reject) =>
130
- setTimeout(() => reject(new Error('预执行超时')), AIService.PRE_EXEC_TIMEOUT)),
131
- ]);
132
- return { name: tool.name, result };
133
- }),
134
- );
135
- for (const r of results) {
136
- if (r.status === 'fulfilled') {
137
- const s = typeof r.value.result === 'string' ? r.value.result : JSON.stringify(r.value.result);
138
- preExecutedData += `\n【${r.value.name}】${s}`;
139
- preExecutedCalls.push({ tool: r.value.name, args: {}, result: r.value.result });
140
- }
141
- }
142
- }
143
-
144
- let finalResponse: string;
145
-
146
- if (paramTools.length === 0 && preExecutedData) {
147
- const singleShotPrompt = `你是一个友好的中文 AI 助手。\n\n以下是根据用户问题自动获取的实时数据:\n${preExecutedData}\n\n请基于以上数据回答用户的问题。用自然流畅的中文组织信息,突出重点。`;
148
- finalResponse = await this.simpleChat(content, singleShotPrompt);
149
- } else {
150
- const agentSystemPrompt = `你是一个友好的中文 AI 助手。
151
- ${preExecutedData ? `\n已自动获取的数据:${preExecutedData}\n` : ''}
152
- ## 关键要求
153
- - 调用工具后**必须**基于结果给出完整中文回答
154
- - 用自然语言总结,突出关键信息`;
155
-
156
- const agent = this.createAgent({
157
- systemPrompt: agentSystemPrompt,
158
- tools: paramTools.length > 0 ? paramTools : relevantTools,
159
- useBuiltinTools: false,
160
- collectExternalTools: false,
161
- maxIterations: 3,
162
- });
163
-
164
- const agentResult = await agent.run(content);
165
- finalResponse = agentResult.content || this.formatToolCallsFallback(
166
- [...preExecutedCalls, ...agentResult.toolCalls],
167
- );
168
- }
169
-
170
- await this.sessions.addMessage(sessionId, { role: 'user', content });
171
- await this.sessions.addMessage(sessionId, { role: 'assistant', content: finalResponse });
172
- if (this.contextManager && sceneId) {
173
- this.contextManager.autoSummarizeIfNeeded(sceneId).catch(() => {});
174
- }
175
- return finalResponse;
176
- }
177
-
178
- private async finishAndSave(sessionId: string, content: string, systemPrompt: string, sceneId?: string): Promise<string> {
179
- const response = await this.simpleChat(content, systemPrompt);
180
- await this.sessions.addMessage(sessionId, { role: 'user', content });
181
- await this.sessions.addMessage(sessionId, { role: 'assistant', content: response });
182
- if (this.contextManager && sceneId) {
183
- this.contextManager.autoSummarizeIfNeeded(sceneId).catch(() => {});
184
- }
185
- return response;
186
- }
187
-
188
- private formatToolCallsFallback(toolCalls: { tool: string; args: any; result: any }[]): string {
189
- if (toolCalls.length === 0) return '处理完成。';
190
- return toolCalls.map(tc => {
191
- const s = typeof tc.result === 'string' ? tc.result : JSON.stringify(tc.result, null, 2);
192
- return `【${tc.tool}】\n${s}`;
193
- }).join('\n\n');
194
- }
195
-
196
- private async simpleChat(content: string, systemPrompt: string): Promise<string> {
197
- const provider = this.getProvider();
198
- const response = await this.chat({
199
- model: provider.models[0],
200
- messages: [
201
- { role: 'system', content: systemPrompt },
202
- { role: 'user', content },
203
- ],
204
- });
205
- const msgContent = response.choices[0]?.message?.content;
206
- return typeof msgContent === 'string' ? msgContent : '';
207
- }
208
-
209
- private collectAllToolsWithExternal(externalTools: Tool[]): AgentTool[] {
210
- const tools: AgentTool[] = [];
211
- tools.push(...this.builtinTools);
212
- tools.push(...this.customTools.values());
213
- for (const tool of externalTools) {
214
- if (tool.name.startsWith('cmd_') || tool.name.startsWith('process_')) continue;
215
- tools.push(this.convertToolToAgentTool(tool));
216
- }
217
- if (tools.length > 30) return tools.slice(0, 30);
218
- return tools;
219
- }
220
-
221
- private static readonly PERM_MAP: Record<string, number> = {
222
- 'user': 0, 'group_admin': 1, 'group_owner': 2, 'bot_admin': 3, 'owner': 4,
223
- };
224
-
225
- private convertToolToAgentTool(tool: Tool): AgentTool {
226
- const agentTool: AgentTool = {
227
- name: tool.name,
228
- description: tool.description,
229
- parameters: tool.parameters as any,
230
- execute: tool.execute,
231
- };
232
- if (tool.tags?.length) agentTool.tags = tool.tags;
233
- if (tool.permissionLevel) agentTool.permissionLevel = AIService.PERM_MAP[tool.permissionLevel] ?? 0;
234
- if ((tool as any).keywords?.length) agentTool.keywords = (tool as any).keywords;
235
- return agentTool;
236
- }
237
-
238
- setSessionManager(manager: SessionManager): void { this.sessions.dispose(); this.sessions = manager; }
239
- setContextManager(manager: ContextManager): void {
240
- this.contextManager = manager;
241
- const defaultProvider = this.providers.get(this.defaultProvider);
242
- if (defaultProvider) manager.setAIProvider(defaultProvider);
243
- }
244
- setPlugin(plugin: Plugin): void { this.plugin = plugin; }
245
- registerTool(tool: AgentTool): () => void { this.customTools.set(tool.name, tool); return () => { this.customTools.delete(tool.name); }; }
246
-
247
- collectAllTools(): AgentTool[] {
248
- const tools: AgentTool[] = [...this.builtinTools, ...this.customTools.values()];
249
- if (this.plugin) {
250
- for (const tool of this.plugin.collectAllTools()) tools.push(this.convertToolToAgentTool(tool));
251
- }
252
- return tools;
253
- }
254
-
255
- getContextConfig(): ContextConfig { return this.contextConfig; }
256
- getSessionConfig() { return this.sessionConfig; }
257
- getTriggerConfig(): AITriggerConfig { return this.triggerConfig; }
258
- /** Agent 配置(如 disabledTools / allowedTools),供 ZhinAgent 使用 */
259
- getAgentConfig(): AIConfig['agent'] { return this.agentConfig; }
260
-
261
- registerProvider(provider: AIProvider): void { this.providers.set(provider.name, provider); }
262
- getProvider(name?: string): AIProvider {
263
- const providerName = name || this.defaultProvider;
264
- const provider = this.providers.get(providerName);
265
- if (!provider) throw new Error(`AI Provider "${providerName}" not found. Available: ${this.listProviders().join(', ')}`);
266
- return provider;
267
- }
268
- listProviders(): string[] { return Array.from(this.providers.keys()); }
269
-
270
- getProviderCapabilities(name?: string): { contextWindow?: number; capabilities?: import('./types.js').ProviderCapabilities } {
271
- const provider = this.getProvider(name);
272
- return {
273
- contextWindow: provider.contextWindow,
274
- capabilities: provider.capabilities,
275
- };
276
- }
277
-
278
- async listModels(providerName?: string): Promise<{ provider: string; models: string[] }[]> {
279
- const result: { provider: string; models: string[] }[] = [];
280
- if (providerName) {
281
- const provider = this.getProvider(providerName);
282
- result.push({ provider: providerName, models: await provider.listModels?.() || provider.models });
283
- } else {
284
- for (const [name, provider] of this.providers) {
285
- result.push({ provider: name, models: await provider.listModels?.() || provider.models });
286
- }
287
- }
288
- return result;
289
- }
290
-
291
- async chat(request: ChatCompletionRequest, providerName?: string): Promise<ChatCompletionResponse> {
292
- return this.getProvider(providerName).chat(request);
293
- }
294
-
295
- async *chatStream(request: ChatCompletionRequest, providerName?: string): AsyncIterable<ChatCompletionChunk> {
296
- yield* this.getProvider(providerName).chatStream(request);
297
- }
298
-
299
- async ask(question: string, options: { provider?: string; model?: string; systemPrompt?: string; temperature?: number } = {}): Promise<string> {
300
- const messages: ChatMessage[] = [];
301
- if (options.systemPrompt) messages.push({ role: 'system', content: options.systemPrompt });
302
- messages.push({ role: 'user', content: question });
303
- const provider = this.getProvider(options.provider);
304
- const response = await provider.chat({ model: options.model || provider.models[0], messages, temperature: options.temperature });
305
- const content = response.choices[0]?.message?.content;
306
- return typeof content === 'string' ? content : '';
307
- }
308
-
309
- createAgent(options: { provider?: string; model?: string; systemPrompt?: string; tools?: AgentTool[]; useBuiltinTools?: boolean; collectExternalTools?: boolean; maxIterations?: number } = {}): Agent {
310
- const provider = this.getProvider(options.provider);
311
- let tools: AgentTool[] = [];
312
- if (options.useBuiltinTools !== false) tools.push(...this.builtinTools);
313
- if (options.collectExternalTools !== false) { tools.push(...this.customTools.values()); if (this.plugin) { for (const t of this.plugin.collectAllTools()) tools.push(this.convertToolToAgentTool(t)); } }
314
- if (options.tools?.length) tools.push(...options.tools);
315
- return createAgent(provider, { model: options.model, systemPrompt: options.systemPrompt, tools, maxIterations: options.maxIterations });
316
- }
317
-
318
- async runAgent(task: string, options: { provider?: string; model?: string; tools?: AgentTool[]; systemPrompt?: string } = {}): Promise<{ content: string; toolCalls: any[]; usage: any }> {
319
- return this.createAgent(options).run(task);
320
- }
321
-
322
- async healthCheck(): Promise<Record<string, boolean>> {
323
- const results: Record<string, boolean> = {};
324
- for (const [name, provider] of this.providers) {
325
- try { results[name] = await provider.healthCheck?.() ?? true; } catch { results[name] = false; }
326
- }
327
- return results;
328
- }
329
-
330
- dispose(): void { this.sessions.dispose(); this.providers.clear(); }
331
- }