opc-agent 1.1.3 → 1.2.1
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.
- package/CHANGELOG.md +6 -0
- package/CONTRIBUTING.md +75 -75
- package/README.md +429 -429
- package/README.zh-CN.md +415 -415
- package/dist/channels/web.js +256 -256
- package/dist/core/streaming.d.ts +56 -0
- package/dist/core/streaming.js +160 -0
- package/dist/deploy/hermes.js +22 -22
- package/dist/deploy/openclaw.js +31 -31
- package/dist/index.d.ts +4 -0
- package/dist/index.js +7 -1
- package/dist/providers/index.d.ts +1 -1
- package/dist/providers/index.js +13 -148
- package/dist/schema/oad.d.ts +3 -3
- package/dist/templates/code-reviewer.js +5 -5
- package/dist/templates/customer-service.js +2 -2
- package/dist/templates/data-analyst.js +5 -5
- package/dist/templates/knowledge-base.js +2 -2
- package/dist/templates/sales-assistant.js +4 -4
- package/dist/templates/teacher.js +6 -6
- package/dist/tools/gateway.d.ts +28 -0
- package/dist/tools/gateway.js +177 -0
- package/docs/.vitepress/config.ts +103 -103
- package/docs/api/cli.md +48 -48
- package/docs/api/oad-schema.md +64 -64
- package/docs/api/sdk.md +80 -80
- package/docs/guide/concepts.md +51 -51
- package/docs/guide/configuration.md +79 -79
- package/docs/guide/deployment.md +42 -42
- package/docs/guide/getting-started.md +44 -44
- package/docs/guide/templates.md +28 -28
- package/docs/guide/testing.md +84 -84
- package/docs/index.md +27 -27
- package/docs/zh/api/cli.md +54 -54
- package/docs/zh/api/oad-schema.md +87 -87
- package/docs/zh/api/sdk.md +102 -102
- package/docs/zh/guide/concepts.md +104 -104
- package/docs/zh/guide/configuration.md +135 -135
- package/docs/zh/guide/deployment.md +81 -81
- package/docs/zh/guide/getting-started.md +82 -82
- package/docs/zh/guide/templates.md +84 -84
- package/docs/zh/guide/testing.md +88 -88
- package/docs/zh/index.md +27 -27
- package/examples/customer-service-demo/README.md +90 -90
- package/examples/customer-service-demo/oad.yaml +107 -107
- package/package.json +1 -1
- package/src/analytics/index.ts +66 -66
- package/src/channels/discord.ts +192 -192
- package/src/channels/email.ts +177 -177
- package/src/channels/feishu.ts +236 -236
- package/src/channels/index.ts +15 -15
- package/src/channels/slack.ts +160 -160
- package/src/channels/telegram.ts +90 -90
- package/src/channels/voice.ts +106 -106
- package/src/channels/web.ts +17 -17
- package/src/channels/webhook.ts +199 -199
- package/src/channels/websocket.ts +87 -87
- package/src/channels/wechat.ts +149 -149
- package/src/core/a2a.ts +143 -143
- package/src/core/agent.ts +152 -152
- package/src/core/analytics-engine.ts +186 -186
- package/src/core/auth.ts +57 -57
- package/src/core/cache.ts +141 -141
- package/src/core/compose.ts +77 -77
- package/src/core/config.ts +14 -14
- package/src/core/errors.ts +148 -148
- package/src/core/hitl.ts +138 -138
- package/src/core/knowledge.ts +49 -4
- package/src/core/logger.ts +57 -57
- package/src/core/orchestrator.ts +215 -215
- package/src/core/performance.ts +187 -187
- package/src/core/rate-limiter.ts +128 -128
- package/src/core/room.ts +109 -109
- package/src/core/runtime.ts +152 -152
- package/src/core/sandbox.ts +101 -101
- package/src/core/security.ts +171 -171
- package/src/core/streaming.ts +195 -0
- package/src/core/types.ts +68 -68
- package/src/core/versioning.ts +106 -106
- package/src/core/watch.ts +178 -178
- package/src/core/workflow.ts +235 -235
- package/src/deploy/hermes.ts +156 -156
- package/src/deploy/openclaw.ts +200 -200
- package/src/dtv/data.ts +29 -29
- package/src/dtv/trust.ts +43 -43
- package/src/dtv/value.ts +47 -47
- package/src/i18n/index.ts +216 -216
- package/src/index.ts +6 -0
- package/src/marketplace/index.ts +223 -223
- package/src/memory/deepbrain.ts +108 -108
- package/src/memory/index.ts +34 -34
- package/src/plugins/index.ts +208 -208
- package/src/providers/index.ts +12 -3
- package/src/schema/oad.ts +155 -155
- package/src/skills/base.ts +16 -16
- package/src/skills/document.ts +100 -100
- package/src/skills/http.ts +35 -35
- package/src/skills/index.ts +27 -27
- package/src/skills/scheduler.ts +80 -80
- package/src/skills/webhook-trigger.ts +59 -59
- package/src/templates/code-reviewer.ts +34 -34
- package/src/templates/customer-service.ts +80 -80
- package/src/templates/data-analyst.ts +70 -70
- package/src/templates/executive-assistant.ts +71 -71
- package/src/templates/financial-advisor.ts +60 -60
- package/src/templates/knowledge-base.ts +31 -31
- package/src/templates/legal-assistant.ts +71 -71
- package/src/templates/sales-assistant.ts +79 -79
- package/src/templates/teacher.ts +79 -79
- package/src/testing/index.ts +181 -181
- package/src/tools/calculator.ts +73 -73
- package/src/tools/datetime.ts +149 -149
- package/src/tools/gateway.ts +220 -0
- package/src/tools/json-transform.ts +187 -187
- package/src/tools/mcp.ts +76 -76
- package/src/tools/text-analysis.ts +116 -116
- package/templates/Dockerfile +15 -15
- package/templates/code-reviewer/README.md +27 -27
- package/templates/code-reviewer/oad.yaml +41 -41
- package/templates/customer-service/README.md +22 -22
- package/templates/customer-service/oad.yaml +36 -36
- package/templates/docker-compose.yml +21 -21
- package/templates/ecommerce-assistant/README.md +45 -0
- package/templates/ecommerce-assistant/oad.yaml +47 -0
- package/templates/knowledge-base/README.md +28 -28
- package/templates/knowledge-base/oad.yaml +38 -38
- package/templates/sales-assistant/README.md +26 -26
- package/templates/sales-assistant/oad.yaml +43 -43
- package/templates/tech-support/README.md +43 -0
- package/templates/tech-support/oad.yaml +45 -0
- package/tests/a2a.test.ts +66 -66
- package/tests/agent.test.ts +72 -72
- package/tests/analytics.test.ts +50 -50
- package/tests/channel.test.ts +39 -39
- package/tests/e2e.test.ts +134 -134
- package/tests/errors.test.ts +83 -83
- package/tests/gateway.test.ts +71 -0
- package/tests/hitl.test.ts +71 -71
- package/tests/i18n.test.ts +41 -41
- package/tests/mcp.test.ts +54 -54
- package/tests/oad.test.ts +68 -68
- package/tests/performance.test.ts +115 -115
- package/tests/plugin.test.ts +74 -74
- package/tests/room.test.ts +106 -106
- package/tests/runtime.test.ts +42 -42
- package/tests/sandbox.test.ts +46 -46
- package/tests/security.test.ts +60 -60
- package/tests/streaming.test.ts +109 -0
- package/tests/templates.test.ts +77 -77
- package/tests/v070.test.ts +76 -76
- package/tests/versioning.test.ts +75 -75
- package/tests/voice.test.ts +61 -61
- package/tests/webhook.test.ts +29 -29
- package/tests/workflow.test.ts +143 -143
- package/tsconfig.json +19 -19
- package/vitest.config.ts +9 -9
package/src/memory/index.ts
CHANGED
|
@@ -1,34 +1,34 @@
|
|
|
1
|
-
import type { Message, MemoryStore } from '../core/types';
|
|
2
|
-
|
|
3
|
-
export class InMemoryStore implements MemoryStore {
|
|
4
|
-
private store: Map<string, unknown> = new Map();
|
|
5
|
-
private conversations: Map<string, Message[]> = new Map();
|
|
6
|
-
|
|
7
|
-
async get(key: string): Promise<unknown> {
|
|
8
|
-
return this.store.get(key);
|
|
9
|
-
}
|
|
10
|
-
|
|
11
|
-
async set(key: string, value: unknown): Promise<void> {
|
|
12
|
-
this.store.set(key, value);
|
|
13
|
-
}
|
|
14
|
-
|
|
15
|
-
async getConversation(sessionId: string): Promise<Message[]> {
|
|
16
|
-
return this.conversations.get(sessionId) ?? [];
|
|
17
|
-
}
|
|
18
|
-
|
|
19
|
-
async addMessage(sessionId: string, message: Message): Promise<void> {
|
|
20
|
-
if (!this.conversations.has(sessionId)) {
|
|
21
|
-
this.conversations.set(sessionId, []);
|
|
22
|
-
}
|
|
23
|
-
this.conversations.get(sessionId)!.push(message);
|
|
24
|
-
}
|
|
25
|
-
|
|
26
|
-
async clear(sessionId?: string): Promise<void> {
|
|
27
|
-
if (sessionId) {
|
|
28
|
-
this.conversations.delete(sessionId);
|
|
29
|
-
} else {
|
|
30
|
-
this.store.clear();
|
|
31
|
-
this.conversations.clear();
|
|
32
|
-
}
|
|
33
|
-
}
|
|
34
|
-
}
|
|
1
|
+
import type { Message, MemoryStore } from '../core/types';
|
|
2
|
+
|
|
3
|
+
export class InMemoryStore implements MemoryStore {
|
|
4
|
+
private store: Map<string, unknown> = new Map();
|
|
5
|
+
private conversations: Map<string, Message[]> = new Map();
|
|
6
|
+
|
|
7
|
+
async get(key: string): Promise<unknown> {
|
|
8
|
+
return this.store.get(key);
|
|
9
|
+
}
|
|
10
|
+
|
|
11
|
+
async set(key: string, value: unknown): Promise<void> {
|
|
12
|
+
this.store.set(key, value);
|
|
13
|
+
}
|
|
14
|
+
|
|
15
|
+
async getConversation(sessionId: string): Promise<Message[]> {
|
|
16
|
+
return this.conversations.get(sessionId) ?? [];
|
|
17
|
+
}
|
|
18
|
+
|
|
19
|
+
async addMessage(sessionId: string, message: Message): Promise<void> {
|
|
20
|
+
if (!this.conversations.has(sessionId)) {
|
|
21
|
+
this.conversations.set(sessionId, []);
|
|
22
|
+
}
|
|
23
|
+
this.conversations.get(sessionId)!.push(message);
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
async clear(sessionId?: string): Promise<void> {
|
|
27
|
+
if (sessionId) {
|
|
28
|
+
this.conversations.delete(sessionId);
|
|
29
|
+
} else {
|
|
30
|
+
this.store.clear();
|
|
31
|
+
this.conversations.clear();
|
|
32
|
+
}
|
|
33
|
+
}
|
|
34
|
+
}
|
package/src/plugins/index.ts
CHANGED
|
@@ -1,208 +1,208 @@
|
|
|
1
|
-
import type { ISkill, IChannel, Message } from '../core/types';
|
|
2
|
-
import type { MCPTool } from '../tools/mcp';
|
|
3
|
-
import { Logger } from '../core/logger';
|
|
4
|
-
|
|
5
|
-
/**
|
|
6
|
-
* Plugin lifecycle hooks - v1.0.0
|
|
7
|
-
*/
|
|
8
|
-
export interface PluginHooks {
|
|
9
|
-
onInit?: () => Promise<void>;
|
|
10
|
-
onMessage?: (message: Message) => Promise<Message | void>;
|
|
11
|
-
onResponse?: (message: Message, response: Message) => Promise<Message | void>;
|
|
12
|
-
onError?: (error: Error, context?: Record<string, unknown>) => Promise<void>;
|
|
13
|
-
onShutdown?: () => Promise<void>;
|
|
14
|
-
// Legacy aliases
|
|
15
|
-
beforeInit?: () => Promise<void>;
|
|
16
|
-
afterInit?: () => Promise<void>;
|
|
17
|
-
beforeMessage?: (message: { content: string }) => Promise<void>;
|
|
18
|
-
afterMessage?: (message: { content: string }, response: { content: string }) => Promise<void>;
|
|
19
|
-
beforeShutdown?: () => Promise<void>;
|
|
20
|
-
}
|
|
21
|
-
|
|
22
|
-
/**
|
|
23
|
-
* Plugin manifest in OAD: plugins: [{ name, config }]
|
|
24
|
-
*/
|
|
25
|
-
export interface PluginManifest {
|
|
26
|
-
name: string;
|
|
27
|
-
config?: Record<string, unknown>;
|
|
28
|
-
}
|
|
29
|
-
|
|
30
|
-
/**
|
|
31
|
-
* Plugin interface - extend agent with skills, tools, channels, and lifecycle hooks.
|
|
32
|
-
*/
|
|
33
|
-
export interface IPlugin {
|
|
34
|
-
name: string;
|
|
35
|
-
version: string;
|
|
36
|
-
description?: string;
|
|
37
|
-
hooks?: PluginHooks;
|
|
38
|
-
skills?: ISkill[];
|
|
39
|
-
tools?: MCPTool[];
|
|
40
|
-
channels?: IChannel[];
|
|
41
|
-
}
|
|
42
|
-
|
|
43
|
-
export class PluginManager {
|
|
44
|
-
private plugins: Map<string, IPlugin> = new Map();
|
|
45
|
-
private logger = new Logger('plugins');
|
|
46
|
-
|
|
47
|
-
register(plugin: IPlugin): void {
|
|
48
|
-
if (this.plugins.has(plugin.name)) {
|
|
49
|
-
this.logger.warn(`Plugin "${plugin.name}" already registered, replacing`);
|
|
50
|
-
}
|
|
51
|
-
this.plugins.set(plugin.name, plugin);
|
|
52
|
-
this.logger.info(`Plugin registered: ${plugin.name}@${plugin.version}`);
|
|
53
|
-
}
|
|
54
|
-
|
|
55
|
-
unregister(name: string): void {
|
|
56
|
-
this.plugins.delete(name);
|
|
57
|
-
}
|
|
58
|
-
|
|
59
|
-
get(name: string): IPlugin | undefined {
|
|
60
|
-
return this.plugins.get(name);
|
|
61
|
-
}
|
|
62
|
-
|
|
63
|
-
list(): { name: string; version: string; description?: string }[] {
|
|
64
|
-
return Array.from(this.plugins.values()).map(({ name, version, description }) => ({
|
|
65
|
-
name, version, description,
|
|
66
|
-
}));
|
|
67
|
-
}
|
|
68
|
-
|
|
69
|
-
has(name: string): boolean {
|
|
70
|
-
return this.plugins.has(name);
|
|
71
|
-
}
|
|
72
|
-
|
|
73
|
-
async runHook(hookName: keyof PluginHooks, ...args: unknown[]): Promise<void> {
|
|
74
|
-
for (const plugin of this.plugins.values()) {
|
|
75
|
-
const hook = plugin.hooks?.[hookName];
|
|
76
|
-
if (hook) {
|
|
77
|
-
try {
|
|
78
|
-
await (hook as (...a: unknown[]) => Promise<void>)(...args);
|
|
79
|
-
} catch (err) {
|
|
80
|
-
this.logger.error(`Plugin "${plugin.name}" hook "${hookName}" failed`, {
|
|
81
|
-
error: err instanceof Error ? err.message : String(err),
|
|
82
|
-
});
|
|
83
|
-
// Don't let one plugin break others
|
|
84
|
-
}
|
|
85
|
-
}
|
|
86
|
-
}
|
|
87
|
-
}
|
|
88
|
-
|
|
89
|
-
async runOnInit(): Promise<void> {
|
|
90
|
-
await this.runHook('onInit');
|
|
91
|
-
await this.runHook('beforeInit');
|
|
92
|
-
await this.runHook('afterInit');
|
|
93
|
-
}
|
|
94
|
-
|
|
95
|
-
async runOnMessage(message: Message): Promise<Message> {
|
|
96
|
-
let msg = message;
|
|
97
|
-
for (const plugin of this.plugins.values()) {
|
|
98
|
-
if (plugin.hooks?.onMessage) {
|
|
99
|
-
const result = await plugin.hooks.onMessage(msg);
|
|
100
|
-
if (result) msg = result;
|
|
101
|
-
}
|
|
102
|
-
if (plugin.hooks?.beforeMessage) {
|
|
103
|
-
await plugin.hooks.beforeMessage({ content: msg.content });
|
|
104
|
-
}
|
|
105
|
-
}
|
|
106
|
-
return msg;
|
|
107
|
-
}
|
|
108
|
-
|
|
109
|
-
async runOnResponse(message: Message, response: Message): Promise<Message> {
|
|
110
|
-
let resp = response;
|
|
111
|
-
for (const plugin of this.plugins.values()) {
|
|
112
|
-
if (plugin.hooks?.onResponse) {
|
|
113
|
-
const result = await plugin.hooks.onResponse(message, resp);
|
|
114
|
-
if (result) resp = result;
|
|
115
|
-
}
|
|
116
|
-
if (plugin.hooks?.afterMessage) {
|
|
117
|
-
await plugin.hooks.afterMessage({ content: message.content }, { content: resp.content });
|
|
118
|
-
}
|
|
119
|
-
}
|
|
120
|
-
return resp;
|
|
121
|
-
}
|
|
122
|
-
|
|
123
|
-
async runOnError(error: Error, context?: Record<string, unknown>): Promise<void> {
|
|
124
|
-
await this.runHook('onError', error, context);
|
|
125
|
-
}
|
|
126
|
-
|
|
127
|
-
async runOnShutdown(): Promise<void> {
|
|
128
|
-
await this.runHook('onShutdown');
|
|
129
|
-
await this.runHook('beforeShutdown');
|
|
130
|
-
}
|
|
131
|
-
|
|
132
|
-
getAllSkills(): ISkill[] {
|
|
133
|
-
const skills: ISkill[] = [];
|
|
134
|
-
for (const plugin of this.plugins.values()) {
|
|
135
|
-
if (plugin.skills) skills.push(...plugin.skills);
|
|
136
|
-
}
|
|
137
|
-
return skills;
|
|
138
|
-
}
|
|
139
|
-
|
|
140
|
-
getAllTools(): MCPTool[] {
|
|
141
|
-
const tools: MCPTool[] = [];
|
|
142
|
-
for (const plugin of this.plugins.values()) {
|
|
143
|
-
if (plugin.tools) tools.push(...plugin.tools);
|
|
144
|
-
}
|
|
145
|
-
return tools;
|
|
146
|
-
}
|
|
147
|
-
|
|
148
|
-
getAllChannels(): IChannel[] {
|
|
149
|
-
const channels: IChannel[] = [];
|
|
150
|
-
for (const plugin of this.plugins.values()) {
|
|
151
|
-
if (plugin.channels) channels.push(...plugin.channels);
|
|
152
|
-
}
|
|
153
|
-
return channels;
|
|
154
|
-
}
|
|
155
|
-
}
|
|
156
|
-
|
|
157
|
-
// ── Built-in Plugins ────────────────────────────────────────
|
|
158
|
-
|
|
159
|
-
export function createLoggingPlugin(): IPlugin {
|
|
160
|
-
const logger = new Logger('agent:messages');
|
|
161
|
-
return {
|
|
162
|
-
name: 'logging',
|
|
163
|
-
version: '1.0.0',
|
|
164
|
-
description: 'Logs all messages and responses',
|
|
165
|
-
hooks: {
|
|
166
|
-
onInit: async () => { logger.info('Agent initialized'); },
|
|
167
|
-
onMessage: async (msg: Message) => { logger.info(`← ${msg.role}: ${msg.content.slice(0, 100)}`); return undefined as any; },
|
|
168
|
-
onResponse: async (_msg: Message, resp: Message) => { logger.info(`→ ${resp.role}: ${resp.content.slice(0, 100)}`); return undefined as any; },
|
|
169
|
-
onError: async (err: Error) => { logger.error(`Error: ${err.message}`); },
|
|
170
|
-
onShutdown: async () => { logger.info('Agent shutting down'); },
|
|
171
|
-
},
|
|
172
|
-
};
|
|
173
|
-
}
|
|
174
|
-
|
|
175
|
-
export function createAnalyticsPlugin(): IPlugin {
|
|
176
|
-
const stats = { messages: 0, errors: 0, startedAt: 0 };
|
|
177
|
-
return {
|
|
178
|
-
name: 'analytics',
|
|
179
|
-
version: '1.0.0',
|
|
180
|
-
description: 'Tracks message counts and error rates',
|
|
181
|
-
hooks: {
|
|
182
|
-
onInit: async () => { stats.startedAt = Date.now(); },
|
|
183
|
-
onMessage: async () => { stats.messages++; return undefined as any; },
|
|
184
|
-
onError: async () => { stats.errors++; },
|
|
185
|
-
},
|
|
186
|
-
};
|
|
187
|
-
}
|
|
188
|
-
|
|
189
|
-
export function createRateLimitPlugin(maxPerMinute = 60): IPlugin {
|
|
190
|
-
const timestamps: number[] = [];
|
|
191
|
-
return {
|
|
192
|
-
name: 'rate-limit',
|
|
193
|
-
version: '1.0.0',
|
|
194
|
-
description: `Rate limits to ${maxPerMinute} messages/minute`,
|
|
195
|
-
hooks: {
|
|
196
|
-
onMessage: async () => {
|
|
197
|
-
const now = Date.now();
|
|
198
|
-
const windowStart = now - 60_000;
|
|
199
|
-
while (timestamps.length > 0 && timestamps[0] < windowStart) timestamps.shift();
|
|
200
|
-
if (timestamps.length >= maxPerMinute) {
|
|
201
|
-
throw new Error('Rate limit exceeded. Please slow down.');
|
|
202
|
-
}
|
|
203
|
-
timestamps.push(now);
|
|
204
|
-
return undefined as any;
|
|
205
|
-
},
|
|
206
|
-
},
|
|
207
|
-
};
|
|
208
|
-
}
|
|
1
|
+
import type { ISkill, IChannel, Message } from '../core/types';
|
|
2
|
+
import type { MCPTool } from '../tools/mcp';
|
|
3
|
+
import { Logger } from '../core/logger';
|
|
4
|
+
|
|
5
|
+
/**
|
|
6
|
+
* Plugin lifecycle hooks - v1.0.0
|
|
7
|
+
*/
|
|
8
|
+
export interface PluginHooks {
|
|
9
|
+
onInit?: () => Promise<void>;
|
|
10
|
+
onMessage?: (message: Message) => Promise<Message | void>;
|
|
11
|
+
onResponse?: (message: Message, response: Message) => Promise<Message | void>;
|
|
12
|
+
onError?: (error: Error, context?: Record<string, unknown>) => Promise<void>;
|
|
13
|
+
onShutdown?: () => Promise<void>;
|
|
14
|
+
// Legacy aliases
|
|
15
|
+
beforeInit?: () => Promise<void>;
|
|
16
|
+
afterInit?: () => Promise<void>;
|
|
17
|
+
beforeMessage?: (message: { content: string }) => Promise<void>;
|
|
18
|
+
afterMessage?: (message: { content: string }, response: { content: string }) => Promise<void>;
|
|
19
|
+
beforeShutdown?: () => Promise<void>;
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
/**
|
|
23
|
+
* Plugin manifest in OAD: plugins: [{ name, config }]
|
|
24
|
+
*/
|
|
25
|
+
export interface PluginManifest {
|
|
26
|
+
name: string;
|
|
27
|
+
config?: Record<string, unknown>;
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
/**
|
|
31
|
+
* Plugin interface - extend agent with skills, tools, channels, and lifecycle hooks.
|
|
32
|
+
*/
|
|
33
|
+
export interface IPlugin {
|
|
34
|
+
name: string;
|
|
35
|
+
version: string;
|
|
36
|
+
description?: string;
|
|
37
|
+
hooks?: PluginHooks;
|
|
38
|
+
skills?: ISkill[];
|
|
39
|
+
tools?: MCPTool[];
|
|
40
|
+
channels?: IChannel[];
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
export class PluginManager {
|
|
44
|
+
private plugins: Map<string, IPlugin> = new Map();
|
|
45
|
+
private logger = new Logger('plugins');
|
|
46
|
+
|
|
47
|
+
register(plugin: IPlugin): void {
|
|
48
|
+
if (this.plugins.has(plugin.name)) {
|
|
49
|
+
this.logger.warn(`Plugin "${plugin.name}" already registered, replacing`);
|
|
50
|
+
}
|
|
51
|
+
this.plugins.set(plugin.name, plugin);
|
|
52
|
+
this.logger.info(`Plugin registered: ${plugin.name}@${plugin.version}`);
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
unregister(name: string): void {
|
|
56
|
+
this.plugins.delete(name);
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
get(name: string): IPlugin | undefined {
|
|
60
|
+
return this.plugins.get(name);
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
list(): { name: string; version: string; description?: string }[] {
|
|
64
|
+
return Array.from(this.plugins.values()).map(({ name, version, description }) => ({
|
|
65
|
+
name, version, description,
|
|
66
|
+
}));
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
has(name: string): boolean {
|
|
70
|
+
return this.plugins.has(name);
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
async runHook(hookName: keyof PluginHooks, ...args: unknown[]): Promise<void> {
|
|
74
|
+
for (const plugin of this.plugins.values()) {
|
|
75
|
+
const hook = plugin.hooks?.[hookName];
|
|
76
|
+
if (hook) {
|
|
77
|
+
try {
|
|
78
|
+
await (hook as (...a: unknown[]) => Promise<void>)(...args);
|
|
79
|
+
} catch (err) {
|
|
80
|
+
this.logger.error(`Plugin "${plugin.name}" hook "${hookName}" failed`, {
|
|
81
|
+
error: err instanceof Error ? err.message : String(err),
|
|
82
|
+
});
|
|
83
|
+
// Don't let one plugin break others
|
|
84
|
+
}
|
|
85
|
+
}
|
|
86
|
+
}
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
async runOnInit(): Promise<void> {
|
|
90
|
+
await this.runHook('onInit');
|
|
91
|
+
await this.runHook('beforeInit');
|
|
92
|
+
await this.runHook('afterInit');
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
async runOnMessage(message: Message): Promise<Message> {
|
|
96
|
+
let msg = message;
|
|
97
|
+
for (const plugin of this.plugins.values()) {
|
|
98
|
+
if (plugin.hooks?.onMessage) {
|
|
99
|
+
const result = await plugin.hooks.onMessage(msg);
|
|
100
|
+
if (result) msg = result;
|
|
101
|
+
}
|
|
102
|
+
if (plugin.hooks?.beforeMessage) {
|
|
103
|
+
await plugin.hooks.beforeMessage({ content: msg.content });
|
|
104
|
+
}
|
|
105
|
+
}
|
|
106
|
+
return msg;
|
|
107
|
+
}
|
|
108
|
+
|
|
109
|
+
async runOnResponse(message: Message, response: Message): Promise<Message> {
|
|
110
|
+
let resp = response;
|
|
111
|
+
for (const plugin of this.plugins.values()) {
|
|
112
|
+
if (plugin.hooks?.onResponse) {
|
|
113
|
+
const result = await plugin.hooks.onResponse(message, resp);
|
|
114
|
+
if (result) resp = result;
|
|
115
|
+
}
|
|
116
|
+
if (plugin.hooks?.afterMessage) {
|
|
117
|
+
await plugin.hooks.afterMessage({ content: message.content }, { content: resp.content });
|
|
118
|
+
}
|
|
119
|
+
}
|
|
120
|
+
return resp;
|
|
121
|
+
}
|
|
122
|
+
|
|
123
|
+
async runOnError(error: Error, context?: Record<string, unknown>): Promise<void> {
|
|
124
|
+
await this.runHook('onError', error, context);
|
|
125
|
+
}
|
|
126
|
+
|
|
127
|
+
async runOnShutdown(): Promise<void> {
|
|
128
|
+
await this.runHook('onShutdown');
|
|
129
|
+
await this.runHook('beforeShutdown');
|
|
130
|
+
}
|
|
131
|
+
|
|
132
|
+
getAllSkills(): ISkill[] {
|
|
133
|
+
const skills: ISkill[] = [];
|
|
134
|
+
for (const plugin of this.plugins.values()) {
|
|
135
|
+
if (plugin.skills) skills.push(...plugin.skills);
|
|
136
|
+
}
|
|
137
|
+
return skills;
|
|
138
|
+
}
|
|
139
|
+
|
|
140
|
+
getAllTools(): MCPTool[] {
|
|
141
|
+
const tools: MCPTool[] = [];
|
|
142
|
+
for (const plugin of this.plugins.values()) {
|
|
143
|
+
if (plugin.tools) tools.push(...plugin.tools);
|
|
144
|
+
}
|
|
145
|
+
return tools;
|
|
146
|
+
}
|
|
147
|
+
|
|
148
|
+
getAllChannels(): IChannel[] {
|
|
149
|
+
const channels: IChannel[] = [];
|
|
150
|
+
for (const plugin of this.plugins.values()) {
|
|
151
|
+
if (plugin.channels) channels.push(...plugin.channels);
|
|
152
|
+
}
|
|
153
|
+
return channels;
|
|
154
|
+
}
|
|
155
|
+
}
|
|
156
|
+
|
|
157
|
+
// ── Built-in Plugins ────────────────────────────────────────
|
|
158
|
+
|
|
159
|
+
export function createLoggingPlugin(): IPlugin {
|
|
160
|
+
const logger = new Logger('agent:messages');
|
|
161
|
+
return {
|
|
162
|
+
name: 'logging',
|
|
163
|
+
version: '1.0.0',
|
|
164
|
+
description: 'Logs all messages and responses',
|
|
165
|
+
hooks: {
|
|
166
|
+
onInit: async () => { logger.info('Agent initialized'); },
|
|
167
|
+
onMessage: async (msg: Message) => { logger.info(`← ${msg.role}: ${msg.content.slice(0, 100)}`); return undefined as any; },
|
|
168
|
+
onResponse: async (_msg: Message, resp: Message) => { logger.info(`→ ${resp.role}: ${resp.content.slice(0, 100)}`); return undefined as any; },
|
|
169
|
+
onError: async (err: Error) => { logger.error(`Error: ${err.message}`); },
|
|
170
|
+
onShutdown: async () => { logger.info('Agent shutting down'); },
|
|
171
|
+
},
|
|
172
|
+
};
|
|
173
|
+
}
|
|
174
|
+
|
|
175
|
+
export function createAnalyticsPlugin(): IPlugin {
|
|
176
|
+
const stats = { messages: 0, errors: 0, startedAt: 0 };
|
|
177
|
+
return {
|
|
178
|
+
name: 'analytics',
|
|
179
|
+
version: '1.0.0',
|
|
180
|
+
description: 'Tracks message counts and error rates',
|
|
181
|
+
hooks: {
|
|
182
|
+
onInit: async () => { stats.startedAt = Date.now(); },
|
|
183
|
+
onMessage: async () => { stats.messages++; return undefined as any; },
|
|
184
|
+
onError: async () => { stats.errors++; },
|
|
185
|
+
},
|
|
186
|
+
};
|
|
187
|
+
}
|
|
188
|
+
|
|
189
|
+
export function createRateLimitPlugin(maxPerMinute = 60): IPlugin {
|
|
190
|
+
const timestamps: number[] = [];
|
|
191
|
+
return {
|
|
192
|
+
name: 'rate-limit',
|
|
193
|
+
version: '1.0.0',
|
|
194
|
+
description: `Rate limits to ${maxPerMinute} messages/minute`,
|
|
195
|
+
hooks: {
|
|
196
|
+
onMessage: async () => {
|
|
197
|
+
const now = Date.now();
|
|
198
|
+
const windowStart = now - 60_000;
|
|
199
|
+
while (timestamps.length > 0 && timestamps[0] < windowStart) timestamps.shift();
|
|
200
|
+
if (timestamps.length >= maxPerMinute) {
|
|
201
|
+
throw new Error('Rate limit exceeded. Please slow down.');
|
|
202
|
+
}
|
|
203
|
+
timestamps.push(now);
|
|
204
|
+
return undefined as any;
|
|
205
|
+
},
|
|
206
|
+
},
|
|
207
|
+
};
|
|
208
|
+
}
|
package/src/providers/index.ts
CHANGED
|
@@ -310,13 +310,22 @@ function isGeminiNative(): boolean {
|
|
|
310
310
|
export function createProvider(name: string = 'openai', model?: string, baseUrl?: string, apiKey?: string): LLMProvider {
|
|
311
311
|
const finalModel = model || process.env.OPC_LLM_MODEL || 'gpt-4o-mini';
|
|
312
312
|
const finalKey = apiKey || getApiKey();
|
|
313
|
+
const finalBaseUrl = baseUrl || getBaseUrl();
|
|
313
314
|
|
|
314
|
-
// Auto-detect Gemini native when key is new format
|
|
315
|
+
// Auto-detect Gemini native when key is new format or base URL points to googleapis
|
|
315
316
|
if (finalKey.startsWith('AQ.') || isGeminiNative()) {
|
|
316
317
|
return new GeminiNativeProvider(finalModel, finalKey);
|
|
317
318
|
}
|
|
318
319
|
|
|
319
|
-
|
|
320
|
+
// Auto-detect provider name from base URL
|
|
321
|
+
let resolvedName = name;
|
|
322
|
+
if (finalBaseUrl.includes('deepseek.com')) {
|
|
323
|
+
resolvedName = 'deepseek';
|
|
324
|
+
} else if (finalBaseUrl.includes('dashscope.aliyuncs.com')) {
|
|
325
|
+
resolvedName = 'qwen';
|
|
326
|
+
}
|
|
327
|
+
|
|
328
|
+
return new OpenAICompatibleProvider(resolvedName, finalModel, baseUrl, apiKey);
|
|
320
329
|
}
|
|
321
330
|
|
|
322
|
-
export const SUPPORTED_PROVIDERS = ['openai', 'deepseek', 'qwen', 'gemini'] as const;
|
|
331
|
+
export const SUPPORTED_PROVIDERS = ['openai', 'deepseek', 'qwen', 'gemini', 'dashscope', 'zhipu', 'moonshot'] as const;
|