opc-agent 1.2.0 → 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/knowledge.d.ts +0 -5
- package/dist/core/knowledge.js +2 -39
- 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 +14 -158
- 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 +50 -50
- 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/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/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/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 -45
- package/templates/ecommerce-assistant/oad.yaml +47 -47
- 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 -43
- package/templates/tech-support/oad.yaml +45 -45
- 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/tests/voice.test.ts
CHANGED
|
@@ -1,61 +1,61 @@
|
|
|
1
|
-
import { describe, it, expect } from 'vitest';
|
|
2
|
-
import { VoiceChannel } from '../src/channels/voice';
|
|
3
|
-
import type { STTProvider, TTSProvider } from '../src/channels/voice';
|
|
4
|
-
|
|
5
|
-
describe('VoiceChannel', () => {
|
|
6
|
-
it('should start and stop', async () => {
|
|
7
|
-
const channel = new VoiceChannel();
|
|
8
|
-
await channel.start();
|
|
9
|
-
expect(channel.isRunning()).toBe(true);
|
|
10
|
-
await channel.stop();
|
|
11
|
-
expect(channel.isRunning()).toBe(false);
|
|
12
|
-
});
|
|
13
|
-
|
|
14
|
-
it('should process audio with STT/TTS providers', async () => {
|
|
15
|
-
const stt: STTProvider = {
|
|
16
|
-
name: 'mock-stt',
|
|
17
|
-
transcribe: async (audio) => audio.toString('utf-8'),
|
|
18
|
-
};
|
|
19
|
-
const tts: TTSProvider = {
|
|
20
|
-
name: 'mock-tts',
|
|
21
|
-
synthesize: async (text) => Buffer.from(`audio:${text}`),
|
|
22
|
-
};
|
|
23
|
-
|
|
24
|
-
const channel = new VoiceChannel({ sttProvider: stt, ttsProvider: tts });
|
|
25
|
-
channel.onMessage(async (msg) => ({
|
|
26
|
-
id: 'r1', role: 'assistant', content: `Reply: ${msg.content}`, timestamp: Date.now(),
|
|
27
|
-
}));
|
|
28
|
-
await channel.start();
|
|
29
|
-
|
|
30
|
-
const result = await channel.processAudio(Buffer.from('hello'));
|
|
31
|
-
expect(result.text).toBe('hello');
|
|
32
|
-
expect(result.response).toBe('Reply: hello');
|
|
33
|
-
expect(result.audioResponse?.toString()).toBe('audio:Reply: hello');
|
|
34
|
-
});
|
|
35
|
-
|
|
36
|
-
it('should work without providers (text fallback)', async () => {
|
|
37
|
-
const channel = new VoiceChannel();
|
|
38
|
-
channel.onMessage(async (msg) => ({
|
|
39
|
-
id: 'r1', role: 'assistant', content: msg.content, timestamp: Date.now(),
|
|
40
|
-
}));
|
|
41
|
-
await channel.start();
|
|
42
|
-
|
|
43
|
-
const result = await channel.processAudio(Buffer.from('test'));
|
|
44
|
-
expect(result.text).toBe('test');
|
|
45
|
-
expect(result.audioResponse).toBeUndefined();
|
|
46
|
-
});
|
|
47
|
-
|
|
48
|
-
it('should throw without handler', async () => {
|
|
49
|
-
const channel = new VoiceChannel();
|
|
50
|
-
await expect(channel.processAudio(Buffer.from('test'))).rejects.toThrow('No message handler');
|
|
51
|
-
});
|
|
52
|
-
|
|
53
|
-
it('should allow setting providers after construction', () => {
|
|
54
|
-
const channel = new VoiceChannel();
|
|
55
|
-
const stt: STTProvider = { name: 'stt', transcribe: async () => 'text' };
|
|
56
|
-
const tts: TTSProvider = { name: 'tts', synthesize: async () => Buffer.from('audio') };
|
|
57
|
-
channel.setSTTProvider(stt);
|
|
58
|
-
channel.setTTSProvider(tts);
|
|
59
|
-
expect(channel.type).toBe('voice');
|
|
60
|
-
});
|
|
61
|
-
});
|
|
1
|
+
import { describe, it, expect } from 'vitest';
|
|
2
|
+
import { VoiceChannel } from '../src/channels/voice';
|
|
3
|
+
import type { STTProvider, TTSProvider } from '../src/channels/voice';
|
|
4
|
+
|
|
5
|
+
describe('VoiceChannel', () => {
|
|
6
|
+
it('should start and stop', async () => {
|
|
7
|
+
const channel = new VoiceChannel();
|
|
8
|
+
await channel.start();
|
|
9
|
+
expect(channel.isRunning()).toBe(true);
|
|
10
|
+
await channel.stop();
|
|
11
|
+
expect(channel.isRunning()).toBe(false);
|
|
12
|
+
});
|
|
13
|
+
|
|
14
|
+
it('should process audio with STT/TTS providers', async () => {
|
|
15
|
+
const stt: STTProvider = {
|
|
16
|
+
name: 'mock-stt',
|
|
17
|
+
transcribe: async (audio) => audio.toString('utf-8'),
|
|
18
|
+
};
|
|
19
|
+
const tts: TTSProvider = {
|
|
20
|
+
name: 'mock-tts',
|
|
21
|
+
synthesize: async (text) => Buffer.from(`audio:${text}`),
|
|
22
|
+
};
|
|
23
|
+
|
|
24
|
+
const channel = new VoiceChannel({ sttProvider: stt, ttsProvider: tts });
|
|
25
|
+
channel.onMessage(async (msg) => ({
|
|
26
|
+
id: 'r1', role: 'assistant', content: `Reply: ${msg.content}`, timestamp: Date.now(),
|
|
27
|
+
}));
|
|
28
|
+
await channel.start();
|
|
29
|
+
|
|
30
|
+
const result = await channel.processAudio(Buffer.from('hello'));
|
|
31
|
+
expect(result.text).toBe('hello');
|
|
32
|
+
expect(result.response).toBe('Reply: hello');
|
|
33
|
+
expect(result.audioResponse?.toString()).toBe('audio:Reply: hello');
|
|
34
|
+
});
|
|
35
|
+
|
|
36
|
+
it('should work without providers (text fallback)', async () => {
|
|
37
|
+
const channel = new VoiceChannel();
|
|
38
|
+
channel.onMessage(async (msg) => ({
|
|
39
|
+
id: 'r1', role: 'assistant', content: msg.content, timestamp: Date.now(),
|
|
40
|
+
}));
|
|
41
|
+
await channel.start();
|
|
42
|
+
|
|
43
|
+
const result = await channel.processAudio(Buffer.from('test'));
|
|
44
|
+
expect(result.text).toBe('test');
|
|
45
|
+
expect(result.audioResponse).toBeUndefined();
|
|
46
|
+
});
|
|
47
|
+
|
|
48
|
+
it('should throw without handler', async () => {
|
|
49
|
+
const channel = new VoiceChannel();
|
|
50
|
+
await expect(channel.processAudio(Buffer.from('test'))).rejects.toThrow('No message handler');
|
|
51
|
+
});
|
|
52
|
+
|
|
53
|
+
it('should allow setting providers after construction', () => {
|
|
54
|
+
const channel = new VoiceChannel();
|
|
55
|
+
const stt: STTProvider = { name: 'stt', transcribe: async () => 'text' };
|
|
56
|
+
const tts: TTSProvider = { name: 'tts', synthesize: async () => Buffer.from('audio') };
|
|
57
|
+
channel.setSTTProvider(stt);
|
|
58
|
+
channel.setTTSProvider(tts);
|
|
59
|
+
expect(channel.type).toBe('voice');
|
|
60
|
+
});
|
|
61
|
+
});
|
package/tests/webhook.test.ts
CHANGED
|
@@ -1,29 +1,29 @@
|
|
|
1
|
-
import { describe, it, expect } from 'vitest';
|
|
2
|
-
import { WebhookChannel } from '../src/channels/webhook';
|
|
3
|
-
|
|
4
|
-
describe('WebhookChannel', () => {
|
|
5
|
-
it('should create with default config', () => {
|
|
6
|
-
const channel = new WebhookChannel();
|
|
7
|
-
expect(channel.type).toBe('webhook');
|
|
8
|
-
});
|
|
9
|
-
|
|
10
|
-
it('should verify signatures', () => {
|
|
11
|
-
const channel = new WebhookChannel({ secret: 'test-secret' });
|
|
12
|
-
const body = '{"event":"test"}';
|
|
13
|
-
const sig = channel.createSignature(body, 'test-secret');
|
|
14
|
-
expect(channel.verifySignature(body, sig, 'test-secret')).toBe(true);
|
|
15
|
-
expect(channel.verifySignature(body, 'invalid', 'test-secret')).toBe(false);
|
|
16
|
-
});
|
|
17
|
-
|
|
18
|
-
it('should add outgoing webhooks', () => {
|
|
19
|
-
const channel = new WebhookChannel();
|
|
20
|
-
channel.addOutgoing({ name: 'test', url: 'http://localhost:9999', events: ['*'], secret: 'abc' });
|
|
21
|
-
expect(channel.type).toBe('webhook');
|
|
22
|
-
});
|
|
23
|
-
|
|
24
|
-
it('should start and stop server', async () => {
|
|
25
|
-
const channel = new WebhookChannel({ port: 0 }); // port 0 = random
|
|
26
|
-
await channel.start();
|
|
27
|
-
await channel.stop();
|
|
28
|
-
});
|
|
29
|
-
});
|
|
1
|
+
import { describe, it, expect } from 'vitest';
|
|
2
|
+
import { WebhookChannel } from '../src/channels/webhook';
|
|
3
|
+
|
|
4
|
+
describe('WebhookChannel', () => {
|
|
5
|
+
it('should create with default config', () => {
|
|
6
|
+
const channel = new WebhookChannel();
|
|
7
|
+
expect(channel.type).toBe('webhook');
|
|
8
|
+
});
|
|
9
|
+
|
|
10
|
+
it('should verify signatures', () => {
|
|
11
|
+
const channel = new WebhookChannel({ secret: 'test-secret' });
|
|
12
|
+
const body = '{"event":"test"}';
|
|
13
|
+
const sig = channel.createSignature(body, 'test-secret');
|
|
14
|
+
expect(channel.verifySignature(body, sig, 'test-secret')).toBe(true);
|
|
15
|
+
expect(channel.verifySignature(body, 'invalid', 'test-secret')).toBe(false);
|
|
16
|
+
});
|
|
17
|
+
|
|
18
|
+
it('should add outgoing webhooks', () => {
|
|
19
|
+
const channel = new WebhookChannel();
|
|
20
|
+
channel.addOutgoing({ name: 'test', url: 'http://localhost:9999', events: ['*'], secret: 'abc' });
|
|
21
|
+
expect(channel.type).toBe('webhook');
|
|
22
|
+
});
|
|
23
|
+
|
|
24
|
+
it('should start and stop server', async () => {
|
|
25
|
+
const channel = new WebhookChannel({ port: 0 }); // port 0 = random
|
|
26
|
+
await channel.start();
|
|
27
|
+
await channel.stop();
|
|
28
|
+
});
|
|
29
|
+
});
|
package/tests/workflow.test.ts
CHANGED
|
@@ -1,143 +1,143 @@
|
|
|
1
|
-
import { describe, it, expect, beforeEach } from 'vitest';
|
|
2
|
-
import { WorkflowEngine, WorkflowDefinition } from '../src/core/workflow';
|
|
3
|
-
import { BaseSkill } from '../src/skills/base';
|
|
4
|
-
import type { AgentContext, Message, SkillResult, MemoryStore } from '../src/core/types';
|
|
5
|
-
|
|
6
|
-
class EchoSkill extends BaseSkill {
|
|
7
|
-
name = 'echo';
|
|
8
|
-
description = 'Echo input';
|
|
9
|
-
async execute(_ctx: AgentContext, msg: Message): Promise<SkillResult> {
|
|
10
|
-
return this.match(`echo:${msg.content}`, 1.0);
|
|
11
|
-
}
|
|
12
|
-
}
|
|
13
|
-
|
|
14
|
-
class UpperSkill extends BaseSkill {
|
|
15
|
-
name = 'upper';
|
|
16
|
-
description = 'Uppercase';
|
|
17
|
-
async execute(_ctx: AgentContext, msg: Message): Promise<SkillResult> {
|
|
18
|
-
return this.match(msg.content.toUpperCase(), 1.0);
|
|
19
|
-
}
|
|
20
|
-
}
|
|
21
|
-
|
|
22
|
-
class FailSkill extends BaseSkill {
|
|
23
|
-
name = 'fail';
|
|
24
|
-
description = 'Always fails';
|
|
25
|
-
async execute(): Promise<SkillResult> {
|
|
26
|
-
throw new Error('intentional failure');
|
|
27
|
-
}
|
|
28
|
-
}
|
|
29
|
-
|
|
30
|
-
const mockMemory: MemoryStore = {
|
|
31
|
-
get: async () => null,
|
|
32
|
-
set: async () => {},
|
|
33
|
-
getConversation: async () => [],
|
|
34
|
-
addMessage: async () => {},
|
|
35
|
-
clear: async () => {},
|
|
36
|
-
};
|
|
37
|
-
|
|
38
|
-
const mockContext: AgentContext = {
|
|
39
|
-
agentName: 'test',
|
|
40
|
-
sessionId: 'test-session',
|
|
41
|
-
messages: [],
|
|
42
|
-
memory: mockMemory,
|
|
43
|
-
metadata: {},
|
|
44
|
-
};
|
|
45
|
-
|
|
46
|
-
describe('WorkflowEngine', () => {
|
|
47
|
-
let engine: WorkflowEngine;
|
|
48
|
-
|
|
49
|
-
beforeEach(() => {
|
|
50
|
-
engine = new WorkflowEngine();
|
|
51
|
-
engine.registerSkill(new EchoSkill());
|
|
52
|
-
engine.registerSkill(new UpperSkill());
|
|
53
|
-
engine.registerSkill(new FailSkill());
|
|
54
|
-
});
|
|
55
|
-
|
|
56
|
-
it('should register and list workflows', () => {
|
|
57
|
-
const wf: WorkflowDefinition = { name: 'test', steps: [] };
|
|
58
|
-
engine.registerWorkflow(wf);
|
|
59
|
-
expect(engine.listWorkflows()).toHaveLength(1);
|
|
60
|
-
expect(engine.getWorkflow('test')).toBeDefined();
|
|
61
|
-
});
|
|
62
|
-
|
|
63
|
-
it('should run sequential steps', async () => {
|
|
64
|
-
const wf: WorkflowDefinition = {
|
|
65
|
-
name: 'seq',
|
|
66
|
-
steps: [
|
|
67
|
-
{ id: 's1', type: 'skill', name: 'echo' },
|
|
68
|
-
{ id: 's2', type: 'skill', name: 'upper' },
|
|
69
|
-
],
|
|
70
|
-
};
|
|
71
|
-
engine.registerWorkflow(wf);
|
|
72
|
-
const result = await engine.run('seq', mockContext, 'hello');
|
|
73
|
-
expect(result.status).toBe('completed');
|
|
74
|
-
expect(result.steps).toHaveLength(2);
|
|
75
|
-
});
|
|
76
|
-
|
|
77
|
-
it('should handle parallel steps', async () => {
|
|
78
|
-
const wf: WorkflowDefinition = {
|
|
79
|
-
name: 'par',
|
|
80
|
-
steps: [{
|
|
81
|
-
id: 'p1', type: 'parallel', name: 'parallel',
|
|
82
|
-
parallel: [
|
|
83
|
-
{ id: 's1', type: 'skill', name: 'echo' },
|
|
84
|
-
{ id: 's2', type: 'skill', name: 'upper' },
|
|
85
|
-
],
|
|
86
|
-
}],
|
|
87
|
-
};
|
|
88
|
-
engine.registerWorkflow(wf);
|
|
89
|
-
const result = await engine.run('par', mockContext, 'test');
|
|
90
|
-
expect(result.status).toBe('completed');
|
|
91
|
-
});
|
|
92
|
-
|
|
93
|
-
it('should handle conditional branching', async () => {
|
|
94
|
-
const wf: WorkflowDefinition = {
|
|
95
|
-
name: 'cond',
|
|
96
|
-
steps: [{
|
|
97
|
-
id: 'c1', type: 'condition', name: 'check',
|
|
98
|
-
condition: 'contains:hello',
|
|
99
|
-
branches: {
|
|
100
|
-
if: [{ id: 's1', type: 'skill', name: 'echo' }],
|
|
101
|
-
else: [{ id: 's2', type: 'skill', name: 'upper' }],
|
|
102
|
-
},
|
|
103
|
-
}],
|
|
104
|
-
};
|
|
105
|
-
engine.registerWorkflow(wf);
|
|
106
|
-
const r1 = await engine.run('cond', mockContext, 'hello world');
|
|
107
|
-
expect(r1.steps.find(s => s.stepId === 's1')).toBeDefined();
|
|
108
|
-
});
|
|
109
|
-
|
|
110
|
-
it('should handle step failures with stop policy', async () => {
|
|
111
|
-
const wf: WorkflowDefinition = {
|
|
112
|
-
name: 'fail-wf',
|
|
113
|
-
onError: 'stop',
|
|
114
|
-
steps: [
|
|
115
|
-
{ id: 's1', type: 'skill', name: 'fail' },
|
|
116
|
-
{ id: 's2', type: 'skill', name: 'echo' },
|
|
117
|
-
],
|
|
118
|
-
};
|
|
119
|
-
engine.registerWorkflow(wf);
|
|
120
|
-
const result = await engine.run('fail-wf', mockContext, 'test');
|
|
121
|
-
expect(result.status).toBe('failed');
|
|
122
|
-
});
|
|
123
|
-
|
|
124
|
-
it('should retry failed steps', async () => {
|
|
125
|
-
const wf: WorkflowDefinition = {
|
|
126
|
-
name: 'retry-wf',
|
|
127
|
-
steps: [{ id: 's1', type: 'skill', name: 'fail', retries: 2 }],
|
|
128
|
-
};
|
|
129
|
-
engine.registerWorkflow(wf);
|
|
130
|
-
const result = await engine.run('retry-wf', mockContext, 'test');
|
|
131
|
-
expect(result.steps[0].status).toBe('error');
|
|
132
|
-
});
|
|
133
|
-
|
|
134
|
-
it('should throw on unknown workflow', async () => {
|
|
135
|
-
await expect(engine.run('nonexistent', mockContext)).rejects.toThrow();
|
|
136
|
-
});
|
|
137
|
-
|
|
138
|
-
it('should unregister workflows', () => {
|
|
139
|
-
engine.registerWorkflow({ name: 'temp', steps: [] });
|
|
140
|
-
engine.unregisterWorkflow('temp');
|
|
141
|
-
expect(engine.getWorkflow('temp')).toBeUndefined();
|
|
142
|
-
});
|
|
143
|
-
});
|
|
1
|
+
import { describe, it, expect, beforeEach } from 'vitest';
|
|
2
|
+
import { WorkflowEngine, WorkflowDefinition } from '../src/core/workflow';
|
|
3
|
+
import { BaseSkill } from '../src/skills/base';
|
|
4
|
+
import type { AgentContext, Message, SkillResult, MemoryStore } from '../src/core/types';
|
|
5
|
+
|
|
6
|
+
class EchoSkill extends BaseSkill {
|
|
7
|
+
name = 'echo';
|
|
8
|
+
description = 'Echo input';
|
|
9
|
+
async execute(_ctx: AgentContext, msg: Message): Promise<SkillResult> {
|
|
10
|
+
return this.match(`echo:${msg.content}`, 1.0);
|
|
11
|
+
}
|
|
12
|
+
}
|
|
13
|
+
|
|
14
|
+
class UpperSkill extends BaseSkill {
|
|
15
|
+
name = 'upper';
|
|
16
|
+
description = 'Uppercase';
|
|
17
|
+
async execute(_ctx: AgentContext, msg: Message): Promise<SkillResult> {
|
|
18
|
+
return this.match(msg.content.toUpperCase(), 1.0);
|
|
19
|
+
}
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
class FailSkill extends BaseSkill {
|
|
23
|
+
name = 'fail';
|
|
24
|
+
description = 'Always fails';
|
|
25
|
+
async execute(): Promise<SkillResult> {
|
|
26
|
+
throw new Error('intentional failure');
|
|
27
|
+
}
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
const mockMemory: MemoryStore = {
|
|
31
|
+
get: async () => null,
|
|
32
|
+
set: async () => {},
|
|
33
|
+
getConversation: async () => [],
|
|
34
|
+
addMessage: async () => {},
|
|
35
|
+
clear: async () => {},
|
|
36
|
+
};
|
|
37
|
+
|
|
38
|
+
const mockContext: AgentContext = {
|
|
39
|
+
agentName: 'test',
|
|
40
|
+
sessionId: 'test-session',
|
|
41
|
+
messages: [],
|
|
42
|
+
memory: mockMemory,
|
|
43
|
+
metadata: {},
|
|
44
|
+
};
|
|
45
|
+
|
|
46
|
+
describe('WorkflowEngine', () => {
|
|
47
|
+
let engine: WorkflowEngine;
|
|
48
|
+
|
|
49
|
+
beforeEach(() => {
|
|
50
|
+
engine = new WorkflowEngine();
|
|
51
|
+
engine.registerSkill(new EchoSkill());
|
|
52
|
+
engine.registerSkill(new UpperSkill());
|
|
53
|
+
engine.registerSkill(new FailSkill());
|
|
54
|
+
});
|
|
55
|
+
|
|
56
|
+
it('should register and list workflows', () => {
|
|
57
|
+
const wf: WorkflowDefinition = { name: 'test', steps: [] };
|
|
58
|
+
engine.registerWorkflow(wf);
|
|
59
|
+
expect(engine.listWorkflows()).toHaveLength(1);
|
|
60
|
+
expect(engine.getWorkflow('test')).toBeDefined();
|
|
61
|
+
});
|
|
62
|
+
|
|
63
|
+
it('should run sequential steps', async () => {
|
|
64
|
+
const wf: WorkflowDefinition = {
|
|
65
|
+
name: 'seq',
|
|
66
|
+
steps: [
|
|
67
|
+
{ id: 's1', type: 'skill', name: 'echo' },
|
|
68
|
+
{ id: 's2', type: 'skill', name: 'upper' },
|
|
69
|
+
],
|
|
70
|
+
};
|
|
71
|
+
engine.registerWorkflow(wf);
|
|
72
|
+
const result = await engine.run('seq', mockContext, 'hello');
|
|
73
|
+
expect(result.status).toBe('completed');
|
|
74
|
+
expect(result.steps).toHaveLength(2);
|
|
75
|
+
});
|
|
76
|
+
|
|
77
|
+
it('should handle parallel steps', async () => {
|
|
78
|
+
const wf: WorkflowDefinition = {
|
|
79
|
+
name: 'par',
|
|
80
|
+
steps: [{
|
|
81
|
+
id: 'p1', type: 'parallel', name: 'parallel',
|
|
82
|
+
parallel: [
|
|
83
|
+
{ id: 's1', type: 'skill', name: 'echo' },
|
|
84
|
+
{ id: 's2', type: 'skill', name: 'upper' },
|
|
85
|
+
],
|
|
86
|
+
}],
|
|
87
|
+
};
|
|
88
|
+
engine.registerWorkflow(wf);
|
|
89
|
+
const result = await engine.run('par', mockContext, 'test');
|
|
90
|
+
expect(result.status).toBe('completed');
|
|
91
|
+
});
|
|
92
|
+
|
|
93
|
+
it('should handle conditional branching', async () => {
|
|
94
|
+
const wf: WorkflowDefinition = {
|
|
95
|
+
name: 'cond',
|
|
96
|
+
steps: [{
|
|
97
|
+
id: 'c1', type: 'condition', name: 'check',
|
|
98
|
+
condition: 'contains:hello',
|
|
99
|
+
branches: {
|
|
100
|
+
if: [{ id: 's1', type: 'skill', name: 'echo' }],
|
|
101
|
+
else: [{ id: 's2', type: 'skill', name: 'upper' }],
|
|
102
|
+
},
|
|
103
|
+
}],
|
|
104
|
+
};
|
|
105
|
+
engine.registerWorkflow(wf);
|
|
106
|
+
const r1 = await engine.run('cond', mockContext, 'hello world');
|
|
107
|
+
expect(r1.steps.find(s => s.stepId === 's1')).toBeDefined();
|
|
108
|
+
});
|
|
109
|
+
|
|
110
|
+
it('should handle step failures with stop policy', async () => {
|
|
111
|
+
const wf: WorkflowDefinition = {
|
|
112
|
+
name: 'fail-wf',
|
|
113
|
+
onError: 'stop',
|
|
114
|
+
steps: [
|
|
115
|
+
{ id: 's1', type: 'skill', name: 'fail' },
|
|
116
|
+
{ id: 's2', type: 'skill', name: 'echo' },
|
|
117
|
+
],
|
|
118
|
+
};
|
|
119
|
+
engine.registerWorkflow(wf);
|
|
120
|
+
const result = await engine.run('fail-wf', mockContext, 'test');
|
|
121
|
+
expect(result.status).toBe('failed');
|
|
122
|
+
});
|
|
123
|
+
|
|
124
|
+
it('should retry failed steps', async () => {
|
|
125
|
+
const wf: WorkflowDefinition = {
|
|
126
|
+
name: 'retry-wf',
|
|
127
|
+
steps: [{ id: 's1', type: 'skill', name: 'fail', retries: 2 }],
|
|
128
|
+
};
|
|
129
|
+
engine.registerWorkflow(wf);
|
|
130
|
+
const result = await engine.run('retry-wf', mockContext, 'test');
|
|
131
|
+
expect(result.steps[0].status).toBe('error');
|
|
132
|
+
});
|
|
133
|
+
|
|
134
|
+
it('should throw on unknown workflow', async () => {
|
|
135
|
+
await expect(engine.run('nonexistent', mockContext)).rejects.toThrow();
|
|
136
|
+
});
|
|
137
|
+
|
|
138
|
+
it('should unregister workflows', () => {
|
|
139
|
+
engine.registerWorkflow({ name: 'temp', steps: [] });
|
|
140
|
+
engine.unregisterWorkflow('temp');
|
|
141
|
+
expect(engine.getWorkflow('temp')).toBeUndefined();
|
|
142
|
+
});
|
|
143
|
+
});
|
package/tsconfig.json
CHANGED
|
@@ -1,19 +1,19 @@
|
|
|
1
|
-
{
|
|
2
|
-
"compilerOptions": {
|
|
3
|
-
"target": "ES2022",
|
|
4
|
-
"module": "commonjs",
|
|
5
|
-
"lib": ["ES2022"],
|
|
6
|
-
"outDir": "dist",
|
|
7
|
-
"rootDir": "src",
|
|
8
|
-
"strict": true,
|
|
9
|
-
"esModuleInterop": true,
|
|
10
|
-
"skipLibCheck": true,
|
|
11
|
-
"forceConsistentCasingInFileNames": true,
|
|
12
|
-
"resolveJsonModule": true,
|
|
13
|
-
"declaration": true,
|
|
14
|
-
"declarationMap": true,
|
|
15
|
-
"sourceMap": true
|
|
16
|
-
},
|
|
17
|
-
"include": ["src/**/*"],
|
|
18
|
-
"exclude": ["node_modules", "dist", "tests"]
|
|
19
|
-
}
|
|
1
|
+
{
|
|
2
|
+
"compilerOptions": {
|
|
3
|
+
"target": "ES2022",
|
|
4
|
+
"module": "commonjs",
|
|
5
|
+
"lib": ["ES2022"],
|
|
6
|
+
"outDir": "dist",
|
|
7
|
+
"rootDir": "src",
|
|
8
|
+
"strict": true,
|
|
9
|
+
"esModuleInterop": true,
|
|
10
|
+
"skipLibCheck": true,
|
|
11
|
+
"forceConsistentCasingInFileNames": true,
|
|
12
|
+
"resolveJsonModule": true,
|
|
13
|
+
"declaration": true,
|
|
14
|
+
"declarationMap": true,
|
|
15
|
+
"sourceMap": true
|
|
16
|
+
},
|
|
17
|
+
"include": ["src/**/*"],
|
|
18
|
+
"exclude": ["node_modules", "dist", "tests"]
|
|
19
|
+
}
|
package/vitest.config.ts
CHANGED
|
@@ -1,9 +1,9 @@
|
|
|
1
|
-
import { defineConfig } from 'vitest/config';
|
|
2
|
-
|
|
3
|
-
export default defineConfig({
|
|
4
|
-
test: {
|
|
5
|
-
globals: true,
|
|
6
|
-
environment: 'node',
|
|
7
|
-
include: ['tests/**/*.test.ts'],
|
|
8
|
-
},
|
|
9
|
-
});
|
|
1
|
+
import { defineConfig } from 'vitest/config';
|
|
2
|
+
|
|
3
|
+
export default defineConfig({
|
|
4
|
+
test: {
|
|
5
|
+
globals: true,
|
|
6
|
+
environment: 'node',
|
|
7
|
+
include: ['tests/**/*.test.ts'],
|
|
8
|
+
},
|
|
9
|
+
});
|