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.
Files changed (155) hide show
  1. package/CHANGELOG.md +6 -0
  2. package/CONTRIBUTING.md +75 -75
  3. package/README.md +429 -429
  4. package/README.zh-CN.md +415 -415
  5. package/dist/channels/web.js +256 -256
  6. package/dist/core/knowledge.d.ts +0 -5
  7. package/dist/core/knowledge.js +2 -39
  8. package/dist/core/streaming.d.ts +56 -0
  9. package/dist/core/streaming.js +160 -0
  10. package/dist/deploy/hermes.js +22 -22
  11. package/dist/deploy/openclaw.js +31 -31
  12. package/dist/index.d.ts +4 -0
  13. package/dist/index.js +7 -1
  14. package/dist/providers/index.d.ts +1 -1
  15. package/dist/providers/index.js +14 -158
  16. package/dist/schema/oad.d.ts +3 -3
  17. package/dist/templates/code-reviewer.js +5 -5
  18. package/dist/templates/customer-service.js +2 -2
  19. package/dist/templates/data-analyst.js +5 -5
  20. package/dist/templates/knowledge-base.js +2 -2
  21. package/dist/templates/sales-assistant.js +4 -4
  22. package/dist/templates/teacher.js +6 -6
  23. package/dist/tools/gateway.d.ts +28 -0
  24. package/dist/tools/gateway.js +177 -0
  25. package/docs/.vitepress/config.ts +103 -103
  26. package/docs/api/cli.md +48 -48
  27. package/docs/api/oad-schema.md +64 -64
  28. package/docs/api/sdk.md +80 -80
  29. package/docs/guide/concepts.md +51 -51
  30. package/docs/guide/configuration.md +79 -79
  31. package/docs/guide/deployment.md +42 -42
  32. package/docs/guide/getting-started.md +44 -44
  33. package/docs/guide/templates.md +28 -28
  34. package/docs/guide/testing.md +84 -84
  35. package/docs/index.md +27 -27
  36. package/docs/zh/api/cli.md +54 -54
  37. package/docs/zh/api/oad-schema.md +87 -87
  38. package/docs/zh/api/sdk.md +102 -102
  39. package/docs/zh/guide/concepts.md +104 -104
  40. package/docs/zh/guide/configuration.md +135 -135
  41. package/docs/zh/guide/deployment.md +81 -81
  42. package/docs/zh/guide/getting-started.md +82 -82
  43. package/docs/zh/guide/templates.md +84 -84
  44. package/docs/zh/guide/testing.md +88 -88
  45. package/docs/zh/index.md +27 -27
  46. package/examples/customer-service-demo/README.md +90 -90
  47. package/examples/customer-service-demo/oad.yaml +107 -107
  48. package/package.json +50 -50
  49. package/src/analytics/index.ts +66 -66
  50. package/src/channels/discord.ts +192 -192
  51. package/src/channels/email.ts +177 -177
  52. package/src/channels/feishu.ts +236 -236
  53. package/src/channels/index.ts +15 -15
  54. package/src/channels/slack.ts +160 -160
  55. package/src/channels/telegram.ts +90 -90
  56. package/src/channels/voice.ts +106 -106
  57. package/src/channels/webhook.ts +199 -199
  58. package/src/channels/websocket.ts +87 -87
  59. package/src/channels/wechat.ts +149 -149
  60. package/src/core/a2a.ts +143 -143
  61. package/src/core/agent.ts +152 -152
  62. package/src/core/analytics-engine.ts +186 -186
  63. package/src/core/auth.ts +57 -57
  64. package/src/core/cache.ts +141 -141
  65. package/src/core/compose.ts +77 -77
  66. package/src/core/config.ts +14 -14
  67. package/src/core/errors.ts +148 -148
  68. package/src/core/hitl.ts +138 -138
  69. package/src/core/logger.ts +57 -57
  70. package/src/core/orchestrator.ts +215 -215
  71. package/src/core/performance.ts +187 -187
  72. package/src/core/rate-limiter.ts +128 -128
  73. package/src/core/room.ts +109 -109
  74. package/src/core/runtime.ts +152 -152
  75. package/src/core/sandbox.ts +101 -101
  76. package/src/core/security.ts +171 -171
  77. package/src/core/streaming.ts +195 -0
  78. package/src/core/types.ts +68 -68
  79. package/src/core/versioning.ts +106 -106
  80. package/src/core/watch.ts +178 -178
  81. package/src/core/workflow.ts +235 -235
  82. package/src/deploy/hermes.ts +156 -156
  83. package/src/deploy/openclaw.ts +200 -200
  84. package/src/dtv/data.ts +29 -29
  85. package/src/dtv/trust.ts +43 -43
  86. package/src/dtv/value.ts +47 -47
  87. package/src/i18n/index.ts +216 -216
  88. package/src/index.ts +6 -0
  89. package/src/marketplace/index.ts +223 -223
  90. package/src/memory/deepbrain.ts +108 -108
  91. package/src/memory/index.ts +34 -34
  92. package/src/plugins/index.ts +208 -208
  93. package/src/schema/oad.ts +155 -155
  94. package/src/skills/base.ts +16 -16
  95. package/src/skills/document.ts +100 -100
  96. package/src/skills/http.ts +35 -35
  97. package/src/skills/index.ts +27 -27
  98. package/src/skills/scheduler.ts +80 -80
  99. package/src/skills/webhook-trigger.ts +59 -59
  100. package/src/templates/code-reviewer.ts +34 -34
  101. package/src/templates/customer-service.ts +80 -80
  102. package/src/templates/data-analyst.ts +70 -70
  103. package/src/templates/executive-assistant.ts +71 -71
  104. package/src/templates/financial-advisor.ts +60 -60
  105. package/src/templates/knowledge-base.ts +31 -31
  106. package/src/templates/legal-assistant.ts +71 -71
  107. package/src/templates/sales-assistant.ts +79 -79
  108. package/src/templates/teacher.ts +79 -79
  109. package/src/testing/index.ts +181 -181
  110. package/src/tools/calculator.ts +73 -73
  111. package/src/tools/datetime.ts +149 -149
  112. package/src/tools/gateway.ts +220 -0
  113. package/src/tools/json-transform.ts +187 -187
  114. package/src/tools/mcp.ts +76 -76
  115. package/src/tools/text-analysis.ts +116 -116
  116. package/templates/Dockerfile +15 -15
  117. package/templates/code-reviewer/README.md +27 -27
  118. package/templates/code-reviewer/oad.yaml +41 -41
  119. package/templates/customer-service/README.md +22 -22
  120. package/templates/customer-service/oad.yaml +36 -36
  121. package/templates/docker-compose.yml +21 -21
  122. package/templates/ecommerce-assistant/README.md +45 -45
  123. package/templates/ecommerce-assistant/oad.yaml +47 -47
  124. package/templates/knowledge-base/README.md +28 -28
  125. package/templates/knowledge-base/oad.yaml +38 -38
  126. package/templates/sales-assistant/README.md +26 -26
  127. package/templates/sales-assistant/oad.yaml +43 -43
  128. package/templates/tech-support/README.md +43 -43
  129. package/templates/tech-support/oad.yaml +45 -45
  130. package/tests/a2a.test.ts +66 -66
  131. package/tests/agent.test.ts +72 -72
  132. package/tests/analytics.test.ts +50 -50
  133. package/tests/channel.test.ts +39 -39
  134. package/tests/e2e.test.ts +134 -134
  135. package/tests/errors.test.ts +83 -83
  136. package/tests/gateway.test.ts +71 -0
  137. package/tests/hitl.test.ts +71 -71
  138. package/tests/i18n.test.ts +41 -41
  139. package/tests/mcp.test.ts +54 -54
  140. package/tests/oad.test.ts +68 -68
  141. package/tests/performance.test.ts +115 -115
  142. package/tests/plugin.test.ts +74 -74
  143. package/tests/room.test.ts +106 -106
  144. package/tests/runtime.test.ts +42 -42
  145. package/tests/sandbox.test.ts +46 -46
  146. package/tests/security.test.ts +60 -60
  147. package/tests/streaming.test.ts +109 -0
  148. package/tests/templates.test.ts +77 -77
  149. package/tests/v070.test.ts +76 -76
  150. package/tests/versioning.test.ts +75 -75
  151. package/tests/voice.test.ts +61 -61
  152. package/tests/webhook.test.ts +29 -29
  153. package/tests/workflow.test.ts +143 -143
  154. package/tsconfig.json +19 -19
  155. package/vitest.config.ts +9 -9
@@ -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
+ });
@@ -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
+ });
@@ -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
+ });