@zhin.js/core 1.0.37 → 1.0.39

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 (204) 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/providers/anthropic.d.ts.map +1 -1
  12. package/lib/ai/providers/anthropic.js +2 -0
  13. package/lib/ai/providers/anthropic.js.map +1 -1
  14. package/lib/ai/providers/openai.d.ts.map +1 -1
  15. package/lib/ai/providers/openai.js +8 -0
  16. package/lib/ai/providers/openai.js.map +1 -1
  17. package/lib/ai/types.d.ts +5 -3
  18. package/lib/ai/types.d.ts.map +1 -1
  19. package/lib/built/ai-trigger.js.map +1 -1
  20. package/lib/built/common-adapter-tools.d.ts +55 -0
  21. package/lib/built/common-adapter-tools.d.ts.map +1 -0
  22. package/lib/built/common-adapter-tools.js +158 -0
  23. package/lib/built/common-adapter-tools.js.map +1 -0
  24. package/lib/built/dispatcher.d.ts.map +1 -1
  25. package/lib/built/dispatcher.js +50 -46
  26. package/lib/built/dispatcher.js.map +1 -1
  27. package/lib/built/skill.d.ts.map +1 -1
  28. package/lib/built/skill.js +0 -1
  29. package/lib/built/skill.js.map +1 -1
  30. package/lib/built/tool.d.ts +3 -3
  31. package/lib/built/tool.d.ts.map +1 -1
  32. package/lib/built/tool.js.map +1 -1
  33. package/lib/feature.d.ts +16 -1
  34. package/lib/feature.d.ts.map +1 -1
  35. package/lib/feature.js +41 -2
  36. package/lib/feature.js.map +1 -1
  37. package/lib/index.d.ts +1 -0
  38. package/lib/index.d.ts.map +1 -1
  39. package/lib/index.js +2 -0
  40. package/lib/index.js.map +1 -1
  41. package/lib/plugin.d.ts +38 -1
  42. package/lib/plugin.d.ts.map +1 -1
  43. package/lib/plugin.js +73 -22
  44. package/lib/plugin.js.map +1 -1
  45. package/lib/scheduler/scheduler.js +1 -1
  46. package/lib/scheduler/scheduler.js.map +1 -1
  47. package/lib/types.d.ts +43 -28
  48. package/lib/types.d.ts.map +1 -1
  49. package/lib/utils.d.ts +12 -3
  50. package/lib/utils.d.ts.map +1 -1
  51. package/lib/utils.js +64 -54
  52. package/lib/utils.js.map +1 -1
  53. package/package.json +5 -5
  54. package/src/adapter.ts +85 -5
  55. package/src/ai/index.ts +8 -186
  56. package/src/ai/providers/anthropic.ts +1 -0
  57. package/src/ai/providers/openai.ts +5 -1
  58. package/src/ai/types.ts +6 -4
  59. package/src/built/ai-trigger.ts +2 -2
  60. package/src/built/common-adapter-tools.ts +207 -0
  61. package/src/built/dispatcher.ts +51 -52
  62. package/src/built/skill.ts +3 -4
  63. package/src/built/tool.ts +3 -3
  64. package/src/feature.ts +45 -2
  65. package/src/index.ts +2 -0
  66. package/src/plugin.ts +92 -31
  67. package/src/scheduler/scheduler.ts +1 -1
  68. package/src/types.ts +39 -28
  69. package/src/utils.ts +63 -52
  70. package/tests/ai/setup.ts +2 -2
  71. package/tests/utils.test.ts +1 -3
  72. package/lib/ai/agent.d.ts +0 -130
  73. package/lib/ai/agent.d.ts.map +0 -1
  74. package/lib/ai/agent.js +0 -702
  75. package/lib/ai/agent.js.map +0 -1
  76. package/lib/ai/bootstrap.d.ts +0 -91
  77. package/lib/ai/bootstrap.d.ts.map +0 -1
  78. package/lib/ai/bootstrap.js +0 -243
  79. package/lib/ai/bootstrap.js.map +0 -1
  80. package/lib/ai/builtin-tools.d.ts +0 -59
  81. package/lib/ai/builtin-tools.d.ts.map +0 -1
  82. package/lib/ai/builtin-tools.js +0 -777
  83. package/lib/ai/builtin-tools.js.map +0 -1
  84. package/lib/ai/compaction.d.ts +0 -132
  85. package/lib/ai/compaction.d.ts.map +0 -1
  86. package/lib/ai/compaction.js +0 -370
  87. package/lib/ai/compaction.js.map +0 -1
  88. package/lib/ai/context-manager.d.ts +0 -213
  89. package/lib/ai/context-manager.d.ts.map +0 -1
  90. package/lib/ai/context-manager.js +0 -313
  91. package/lib/ai/context-manager.js.map +0 -1
  92. package/lib/ai/conversation-memory.d.ts +0 -181
  93. package/lib/ai/conversation-memory.d.ts.map +0 -1
  94. package/lib/ai/conversation-memory.js +0 -581
  95. package/lib/ai/conversation-memory.js.map +0 -1
  96. package/lib/ai/cron-engine.d.ts +0 -92
  97. package/lib/ai/cron-engine.d.ts.map +0 -1
  98. package/lib/ai/cron-engine.js +0 -278
  99. package/lib/ai/cron-engine.js.map +0 -1
  100. package/lib/ai/follow-up.d.ts +0 -131
  101. package/lib/ai/follow-up.d.ts.map +0 -1
  102. package/lib/ai/follow-up.js +0 -265
  103. package/lib/ai/follow-up.js.map +0 -1
  104. package/lib/ai/hooks.d.ts +0 -143
  105. package/lib/ai/hooks.d.ts.map +0 -1
  106. package/lib/ai/hooks.js +0 -108
  107. package/lib/ai/hooks.js.map +0 -1
  108. package/lib/ai/init.d.ts +0 -30
  109. package/lib/ai/init.d.ts.map +0 -1
  110. package/lib/ai/init.js +0 -686
  111. package/lib/ai/init.js.map +0 -1
  112. package/lib/ai/output.d.ts +0 -93
  113. package/lib/ai/output.d.ts.map +0 -1
  114. package/lib/ai/output.js +0 -176
  115. package/lib/ai/output.js.map +0 -1
  116. package/lib/ai/rate-limiter.d.ts +0 -38
  117. package/lib/ai/rate-limiter.d.ts.map +0 -1
  118. package/lib/ai/rate-limiter.js +0 -86
  119. package/lib/ai/rate-limiter.js.map +0 -1
  120. package/lib/ai/service.d.ts +0 -88
  121. package/lib/ai/service.d.ts.map +0 -1
  122. package/lib/ai/service.js +0 -285
  123. package/lib/ai/service.js.map +0 -1
  124. package/lib/ai/session.d.ts +0 -186
  125. package/lib/ai/session.d.ts.map +0 -1
  126. package/lib/ai/session.js +0 -443
  127. package/lib/ai/session.js.map +0 -1
  128. package/lib/ai/subagent.d.ts +0 -50
  129. package/lib/ai/subagent.d.ts.map +0 -1
  130. package/lib/ai/subagent.js +0 -144
  131. package/lib/ai/subagent.js.map +0 -1
  132. package/lib/ai/tone-detector.d.ts +0 -19
  133. package/lib/ai/tone-detector.d.ts.map +0 -1
  134. package/lib/ai/tone-detector.js +0 -72
  135. package/lib/ai/tone-detector.js.map +0 -1
  136. package/lib/ai/tools.d.ts +0 -45
  137. package/lib/ai/tools.d.ts.map +0 -1
  138. package/lib/ai/tools.js +0 -206
  139. package/lib/ai/tools.js.map +0 -1
  140. package/lib/ai/user-profile.d.ts +0 -56
  141. package/lib/ai/user-profile.d.ts.map +0 -1
  142. package/lib/ai/user-profile.js +0 -130
  143. package/lib/ai/user-profile.js.map +0 -1
  144. package/lib/ai/zhin-agent/builtin-tools.d.ts +0 -17
  145. package/lib/ai/zhin-agent/builtin-tools.d.ts.map +0 -1
  146. package/lib/ai/zhin-agent/builtin-tools.js +0 -220
  147. package/lib/ai/zhin-agent/builtin-tools.js.map +0 -1
  148. package/lib/ai/zhin-agent/config.d.ts +0 -54
  149. package/lib/ai/zhin-agent/config.d.ts.map +0 -1
  150. package/lib/ai/zhin-agent/config.js +0 -76
  151. package/lib/ai/zhin-agent/config.js.map +0 -1
  152. package/lib/ai/zhin-agent/exec-policy.d.ts +0 -20
  153. package/lib/ai/zhin-agent/exec-policy.d.ts.map +0 -1
  154. package/lib/ai/zhin-agent/exec-policy.js +0 -71
  155. package/lib/ai/zhin-agent/exec-policy.js.map +0 -1
  156. package/lib/ai/zhin-agent/index.d.ts +0 -70
  157. package/lib/ai/zhin-agent/index.d.ts.map +0 -1
  158. package/lib/ai/zhin-agent/index.js +0 -404
  159. package/lib/ai/zhin-agent/index.js.map +0 -1
  160. package/lib/ai/zhin-agent/prompt.d.ts +0 -21
  161. package/lib/ai/zhin-agent/prompt.d.ts.map +0 -1
  162. package/lib/ai/zhin-agent/prompt.js +0 -111
  163. package/lib/ai/zhin-agent/prompt.js.map +0 -1
  164. package/lib/ai/zhin-agent/tool-collector.d.ts +0 -22
  165. package/lib/ai/zhin-agent/tool-collector.d.ts.map +0 -1
  166. package/lib/ai/zhin-agent/tool-collector.js +0 -218
  167. package/lib/ai/zhin-agent/tool-collector.js.map +0 -1
  168. package/src/ai/agent.ts +0 -831
  169. package/src/ai/bootstrap.ts +0 -309
  170. package/src/ai/builtin-tools.ts +0 -849
  171. package/src/ai/compaction.ts +0 -529
  172. package/src/ai/context-manager.ts +0 -440
  173. package/src/ai/conversation-memory.ts +0 -774
  174. package/src/ai/cron-engine.ts +0 -337
  175. package/src/ai/follow-up.ts +0 -357
  176. package/src/ai/hooks.ts +0 -223
  177. package/src/ai/init.ts +0 -762
  178. package/src/ai/output.ts +0 -261
  179. package/src/ai/rate-limiter.ts +0 -129
  180. package/src/ai/service.ts +0 -331
  181. package/src/ai/session.ts +0 -544
  182. package/src/ai/subagent.ts +0 -209
  183. package/src/ai/tone-detector.ts +0 -89
  184. package/src/ai/tools.ts +0 -218
  185. package/src/ai/user-profile.ts +0 -181
  186. package/src/ai/zhin-agent/builtin-tools.ts +0 -247
  187. package/src/ai/zhin-agent/config.ts +0 -113
  188. package/src/ai/zhin-agent/exec-policy.ts +0 -78
  189. package/src/ai/zhin-agent/index.ts +0 -512
  190. package/src/ai/zhin-agent/prompt.ts +0 -131
  191. package/src/ai/zhin-agent/tool-collector.ts +0 -243
  192. package/tests/ai/agent.test.ts +0 -614
  193. package/tests/ai/context-manager.test.ts +0 -413
  194. package/tests/ai/conversation-memory.test.ts +0 -128
  195. package/tests/ai/follow-up.test.ts +0 -175
  196. package/tests/ai/integration.test.ts +0 -584
  197. package/tests/ai/output.test.ts +0 -128
  198. package/tests/ai/rate-limiter.test.ts +0 -108
  199. package/tests/ai/session.test.ts +0 -375
  200. package/tests/ai/subagent.test.ts +0 -270
  201. package/tests/ai/tone-detector.test.ts +0 -80
  202. package/tests/ai/tools-builtin.test.ts +0 -346
  203. package/tests/ai/user-profile.test.ts +0 -73
  204. 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
- }