opc-agent 1.1.0 → 1.1.2

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