opc-agent 1.4.0 → 1.4.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 (192) hide show
  1. package/CHANGELOG.md +69 -23
  2. package/CONTRIBUTING.md +60 -21
  3. package/README.md +358 -235
  4. package/README.zh-CN.md +415 -415
  5. package/dist/channels/slack.js +10 -93
  6. package/dist/channels/web.d.ts +0 -10
  7. package/dist/channels/web.js +2 -33
  8. package/dist/cli.js +60 -255
  9. package/dist/core/dashboard.d.ts +35 -0
  10. package/dist/core/dashboard.js +157 -0
  11. package/dist/core/fast-mode.d.ts +27 -0
  12. package/dist/core/fast-mode.js +59 -0
  13. package/dist/core/priority.d.ts +52 -0
  14. package/dist/core/priority.js +102 -0
  15. package/dist/core/runtime.d.ts +0 -4
  16. package/dist/core/runtime.js +0 -27
  17. package/dist/deploy/hermes.js +22 -22
  18. package/dist/deploy/openclaw.js +40 -31
  19. package/dist/index.d.ts +14 -3
  20. package/dist/index.js +20 -6
  21. package/dist/memory/cloud-storage.d.ts +40 -0
  22. package/dist/memory/cloud-storage.js +211 -0
  23. package/dist/providers/index.d.ts +1 -1
  24. package/dist/providers/index.js +1 -7
  25. package/dist/schema/oad.d.ts +2 -1
  26. package/dist/templates/code-reviewer.d.ts +8 -0
  27. package/dist/templates/code-reviewer.js +9 -5
  28. package/dist/templates/customer-service.d.ts +8 -0
  29. package/dist/templates/customer-service.js +6 -2
  30. package/dist/templates/data-analyst.d.ts +8 -0
  31. package/dist/templates/data-analyst.js +9 -5
  32. package/dist/templates/knowledge-base.d.ts +8 -0
  33. package/dist/templates/knowledge-base.js +6 -2
  34. package/dist/templates/sales-assistant.d.ts +8 -0
  35. package/dist/templates/sales-assistant.js +8 -4
  36. package/dist/templates/teacher.d.ts +8 -0
  37. package/dist/templates/teacher.js +10 -6
  38. package/docs/.vitepress/config.ts +103 -103
  39. package/docs/api/cli.md +48 -48
  40. package/docs/api/oad-schema.md +64 -64
  41. package/docs/api/sdk.md +80 -80
  42. package/docs/guide/concepts.md +51 -51
  43. package/docs/guide/configuration.md +79 -79
  44. package/docs/guide/deployment.md +42 -42
  45. package/docs/guide/getting-started.md +44 -44
  46. package/docs/guide/templates.md +28 -28
  47. package/docs/guide/testing.md +84 -84
  48. package/docs/index.md +27 -27
  49. package/docs/zh/api/cli.md +54 -54
  50. package/docs/zh/api/oad-schema.md +87 -87
  51. package/docs/zh/api/sdk.md +102 -102
  52. package/docs/zh/guide/concepts.md +104 -104
  53. package/docs/zh/guide/configuration.md +135 -135
  54. package/docs/zh/guide/deployment.md +81 -81
  55. package/docs/zh/guide/getting-started.md +82 -82
  56. package/docs/zh/guide/templates.md +84 -84
  57. package/docs/zh/guide/testing.md +88 -88
  58. package/docs/zh/index.md +27 -27
  59. package/examples/customer-service-demo/README.md +90 -90
  60. package/examples/customer-service-demo/oad.yaml +107 -107
  61. package/package.json +1 -1
  62. package/src/analytics/index.ts +66 -66
  63. package/src/channels/discord.ts +192 -192
  64. package/src/channels/email.ts +177 -177
  65. package/src/channels/feishu.ts +236 -236
  66. package/src/channels/index.ts +15 -15
  67. package/src/channels/slack.ts +160 -217
  68. package/src/channels/telegram.ts +90 -90
  69. package/src/channels/voice.ts +106 -106
  70. package/src/channels/web.ts +2 -38
  71. package/src/channels/webhook.ts +199 -199
  72. package/src/channels/websocket.ts +87 -87
  73. package/src/channels/wechat.ts +149 -149
  74. package/src/cli.ts +58 -282
  75. package/src/core/a2a.ts +143 -143
  76. package/src/core/agent.ts +152 -152
  77. package/src/core/analytics-engine.ts +186 -186
  78. package/src/core/auth.ts +57 -57
  79. package/src/core/cache.ts +141 -141
  80. package/src/core/compose.ts +77 -77
  81. package/src/core/config.ts +14 -14
  82. package/src/core/dashboard.ts +219 -0
  83. package/src/core/errors.ts +148 -148
  84. package/src/core/fast-mode.ts +75 -0
  85. package/src/core/hitl.ts +138 -138
  86. package/src/core/logger.ts +57 -57
  87. package/src/core/orchestrator.ts +215 -215
  88. package/src/core/performance.ts +187 -187
  89. package/src/core/priority.ts +140 -0
  90. package/src/core/rate-limiter.ts +128 -128
  91. package/src/core/room.ts +109 -109
  92. package/src/core/runtime.ts +152 -183
  93. package/src/core/sandbox.ts +101 -101
  94. package/src/core/security.ts +171 -171
  95. package/src/core/types.ts +68 -68
  96. package/src/core/versioning.ts +106 -106
  97. package/src/core/watch.ts +178 -178
  98. package/src/core/workflow.ts +235 -235
  99. package/src/deploy/hermes.ts +156 -156
  100. package/src/deploy/openclaw.ts +200 -190
  101. package/src/dtv/data.ts +29 -0
  102. package/src/dtv/trust.ts +43 -0
  103. package/src/dtv/value.ts +47 -0
  104. package/src/i18n/index.ts +216 -216
  105. package/src/index.ts +16 -3
  106. package/src/marketplace/index.ts +223 -0
  107. package/src/memory/cloud-storage.ts +217 -0
  108. package/src/memory/deepbrain.ts +108 -108
  109. package/src/memory/index.ts +34 -34
  110. package/src/plugins/index.ts +208 -208
  111. package/src/providers/index.ts +1 -9
  112. package/src/schema/oad.ts +155 -154
  113. package/src/skills/base.ts +16 -16
  114. package/src/skills/document.ts +100 -100
  115. package/src/skills/http.ts +35 -35
  116. package/src/skills/index.ts +27 -27
  117. package/src/skills/scheduler.ts +80 -80
  118. package/src/skills/webhook-trigger.ts +59 -59
  119. package/src/templates/code-reviewer.ts +34 -30
  120. package/src/templates/customer-service.ts +80 -76
  121. package/src/templates/data-analyst.ts +70 -66
  122. package/src/templates/executive-assistant.ts +71 -71
  123. package/src/templates/financial-advisor.ts +60 -60
  124. package/src/templates/knowledge-base.ts +31 -27
  125. package/src/templates/legal-assistant.ts +71 -71
  126. package/src/templates/sales-assistant.ts +79 -75
  127. package/src/templates/teacher.ts +79 -75
  128. package/src/testing/index.ts +181 -181
  129. package/src/tools/calculator.ts +73 -73
  130. package/src/tools/datetime.ts +149 -149
  131. package/src/tools/json-transform.ts +187 -187
  132. package/src/tools/mcp.ts +76 -76
  133. package/src/tools/text-analysis.ts +116 -116
  134. package/templates/Dockerfile +15 -15
  135. package/templates/code-reviewer/README.md +27 -27
  136. package/templates/code-reviewer/oad.yaml +41 -41
  137. package/templates/customer-service/README.md +22 -22
  138. package/templates/customer-service/oad.yaml +36 -36
  139. package/templates/docker-compose.yml +21 -21
  140. package/templates/ecommerce-assistant/README.md +45 -45
  141. package/templates/ecommerce-assistant/oad.yaml +47 -47
  142. package/templates/knowledge-base/README.md +28 -28
  143. package/templates/knowledge-base/oad.yaml +38 -38
  144. package/templates/sales-assistant/README.md +26 -26
  145. package/templates/sales-assistant/oad.yaml +43 -43
  146. package/templates/tech-support/README.md +43 -43
  147. package/templates/tech-support/oad.yaml +45 -45
  148. package/tests/a2a.test.ts +66 -66
  149. package/tests/agent.test.ts +72 -72
  150. package/tests/analytics.test.ts +50 -50
  151. package/tests/channel.test.ts +39 -39
  152. package/tests/e2e.test.ts +134 -134
  153. package/tests/errors.test.ts +83 -83
  154. package/tests/hitl.test.ts +71 -71
  155. package/tests/i18n.test.ts +41 -41
  156. package/tests/mcp.test.ts +54 -54
  157. package/tests/oad.test.ts +68 -68
  158. package/tests/performance.test.ts +115 -115
  159. package/tests/plugin.test.ts +74 -74
  160. package/tests/room.test.ts +106 -106
  161. package/tests/runtime.test.ts +42 -42
  162. package/tests/sandbox.test.ts +46 -46
  163. package/tests/security.test.ts +60 -60
  164. package/tests/templates.test.ts +77 -77
  165. package/tests/v070.test.ts +76 -76
  166. package/tests/versioning.test.ts +75 -75
  167. package/tests/voice.test.ts +61 -61
  168. package/tests/webhook.test.ts +29 -29
  169. package/tests/workflow.test.ts +143 -143
  170. package/tsconfig.json +19 -19
  171. package/vitest.config.ts +9 -9
  172. package/.github/ISSUE_TEMPLATE/bug_report.md +0 -20
  173. package/.github/ISSUE_TEMPLATE/feature_request.md +0 -14
  174. package/.github/PULL_REQUEST_TEMPLATE.md +0 -13
  175. package/.github/workflows/ci.yml +0 -24
  176. package/dist/traces/index.d.ts +0 -49
  177. package/dist/traces/index.js +0 -102
  178. package/examples/README.md +0 -22
  179. package/examples/basic-agent.ts +0 -90
  180. package/examples/brain-integration.ts +0 -71
  181. package/examples/multi-channel.ts +0 -74
  182. package/src/traces/index.ts +0 -132
  183. package/test-agent/Dockerfile +0 -9
  184. package/test-agent/README.md +0 -50
  185. package/test-agent/agent.yaml +0 -23
  186. package/test-agent/docker-compose.yml +0 -11
  187. package/test-agent/oad.yaml +0 -31
  188. package/test-agent/package-lock.json +0 -1492
  189. package/test-agent/package.json +0 -18
  190. package/test-agent/src/index.ts +0 -24
  191. package/test-agent/src/skills/echo.ts +0 -15
  192. package/test-agent/tsconfig.json +0 -25
@@ -1,80 +1,80 @@
1
- import { BaseSkill } from './base';
2
- import type { AgentContext, Message, SkillResult } from '../core/types';
3
-
4
- export interface ScheduledTask {
5
- id: string;
6
- name: string;
7
- cronExpr: string;
8
- action: string;
9
- enabled: boolean;
10
- lastRun?: number;
11
- nextRun?: number;
12
- }
13
-
14
- export class SchedulerSkill extends BaseSkill {
15
- name = 'scheduler';
16
- description = 'Schedule recurring tasks. Usage: schedule list | schedule add <name> <cron> <action> | schedule remove <id>';
17
- private tasks: Map<string, ScheduledTask> = new Map();
18
- private timers: Map<string, NodeJS.Timeout> = new Map();
19
-
20
- async execute(context: AgentContext, message: Message): Promise<SkillResult> {
21
- const text = message.content.trim();
22
-
23
- if (/^schedule\s+list$/i.test(text)) {
24
- if (this.tasks.size === 0) return this.match('No scheduled tasks.');
25
- const lines = Array.from(this.tasks.values()).map(t =>
26
- `• ${t.name} (${t.id}) — ${t.cronExpr} — ${t.enabled ? '✅' : '❌'} — Last: ${t.lastRun ? new Date(t.lastRun).toISOString() : 'never'}`
27
- );
28
- return this.match(`Scheduled tasks:\n${lines.join('\n')}`);
29
- }
30
-
31
- const addMatch = text.match(/^schedule\s+add\s+(\S+)\s+(".*?"|\S+)\s+(.+)$/i);
32
- if (addMatch) {
33
- const [, name, cronExpr, action] = addMatch;
34
- const id = `task_${Date.now().toString(36)}`;
35
- const task: ScheduledTask = {
36
- id, name, cronExpr: cronExpr.replace(/"/g, ''), action, enabled: true,
37
- };
38
- this.tasks.set(id, task);
39
- // Simple interval-based scheduling (parse cron for interval in minutes)
40
- const intervalMs = this.parseCronToInterval(task.cronExpr);
41
- if (intervalMs > 0) {
42
- const timer = setInterval(() => {
43
- task.lastRun = Date.now();
44
- }, intervalMs);
45
- this.timers.set(id, timer);
46
- }
47
- return this.match(`Task scheduled: ${name} (${id}) — ${task.cronExpr} → "${action}"`);
48
- }
49
-
50
- const rmMatch = text.match(/^schedule\s+remove\s+(\S+)$/i);
51
- if (rmMatch) {
52
- const id = rmMatch[1];
53
- const timer = this.timers.get(id);
54
- if (timer) clearInterval(timer);
55
- this.timers.delete(id);
56
- const removed = this.tasks.delete(id);
57
- return this.match(removed ? `Task ${id} removed.` : `Task ${id} not found.`);
58
- }
59
-
60
- return this.noMatch();
61
- }
62
-
63
- private parseCronToInterval(expr: string): number {
64
- // Simple: support "every Xm" or "every Xh" or basic intervals
65
- const m = expr.match(/every\s+(\d+)\s*(m|min|h|hr|s|sec)/i);
66
- if (m) {
67
- const val = parseInt(m[1]);
68
- const unit = m[2].toLowerCase();
69
- if (unit.startsWith('h')) return val * 3600_000;
70
- if (unit.startsWith('m')) return val * 60_000;
71
- if (unit.startsWith('s')) return val * 1000;
72
- }
73
- return 0; // Unknown cron format, no auto-schedule
74
- }
75
-
76
- destroy(): void {
77
- for (const timer of this.timers.values()) clearInterval(timer);
78
- this.timers.clear();
79
- }
80
- }
1
+ import { BaseSkill } from './base';
2
+ import type { AgentContext, Message, SkillResult } from '../core/types';
3
+
4
+ export interface ScheduledTask {
5
+ id: string;
6
+ name: string;
7
+ cronExpr: string;
8
+ action: string;
9
+ enabled: boolean;
10
+ lastRun?: number;
11
+ nextRun?: number;
12
+ }
13
+
14
+ export class SchedulerSkill extends BaseSkill {
15
+ name = 'scheduler';
16
+ description = 'Schedule recurring tasks. Usage: schedule list | schedule add <name> <cron> <action> | schedule remove <id>';
17
+ private tasks: Map<string, ScheduledTask> = new Map();
18
+ private timers: Map<string, NodeJS.Timeout> = new Map();
19
+
20
+ async execute(context: AgentContext, message: Message): Promise<SkillResult> {
21
+ const text = message.content.trim();
22
+
23
+ if (/^schedule\s+list$/i.test(text)) {
24
+ if (this.tasks.size === 0) return this.match('No scheduled tasks.');
25
+ const lines = Array.from(this.tasks.values()).map(t =>
26
+ `• ${t.name} (${t.id}) — ${t.cronExpr} — ${t.enabled ? '✅' : '❌'} — Last: ${t.lastRun ? new Date(t.lastRun).toISOString() : 'never'}`
27
+ );
28
+ return this.match(`Scheduled tasks:\n${lines.join('\n')}`);
29
+ }
30
+
31
+ const addMatch = text.match(/^schedule\s+add\s+(\S+)\s+(".*?"|\S+)\s+(.+)$/i);
32
+ if (addMatch) {
33
+ const [, name, cronExpr, action] = addMatch;
34
+ const id = `task_${Date.now().toString(36)}`;
35
+ const task: ScheduledTask = {
36
+ id, name, cronExpr: cronExpr.replace(/"/g, ''), action, enabled: true,
37
+ };
38
+ this.tasks.set(id, task);
39
+ // Simple interval-based scheduling (parse cron for interval in minutes)
40
+ const intervalMs = this.parseCronToInterval(task.cronExpr);
41
+ if (intervalMs > 0) {
42
+ const timer = setInterval(() => {
43
+ task.lastRun = Date.now();
44
+ }, intervalMs);
45
+ this.timers.set(id, timer);
46
+ }
47
+ return this.match(`Task scheduled: ${name} (${id}) — ${task.cronExpr} → "${action}"`);
48
+ }
49
+
50
+ const rmMatch = text.match(/^schedule\s+remove\s+(\S+)$/i);
51
+ if (rmMatch) {
52
+ const id = rmMatch[1];
53
+ const timer = this.timers.get(id);
54
+ if (timer) clearInterval(timer);
55
+ this.timers.delete(id);
56
+ const removed = this.tasks.delete(id);
57
+ return this.match(removed ? `Task ${id} removed.` : `Task ${id} not found.`);
58
+ }
59
+
60
+ return this.noMatch();
61
+ }
62
+
63
+ private parseCronToInterval(expr: string): number {
64
+ // Simple: support "every Xm" or "every Xh" or basic intervals
65
+ const m = expr.match(/every\s+(\d+)\s*(m|min|h|hr|s|sec)/i);
66
+ if (m) {
67
+ const val = parseInt(m[1]);
68
+ const unit = m[2].toLowerCase();
69
+ if (unit.startsWith('h')) return val * 3600_000;
70
+ if (unit.startsWith('m')) return val * 60_000;
71
+ if (unit.startsWith('s')) return val * 1000;
72
+ }
73
+ return 0; // Unknown cron format, no auto-schedule
74
+ }
75
+
76
+ destroy(): void {
77
+ for (const timer of this.timers.values()) clearInterval(timer);
78
+ this.timers.clear();
79
+ }
80
+ }
@@ -1,59 +1,59 @@
1
- import { BaseSkill } from './base';
2
- import type { AgentContext, Message, SkillResult } from '../core/types';
3
-
4
- export interface WebhookTarget {
5
- name: string;
6
- url: string;
7
- method?: string;
8
- headers?: Record<string, string>;
9
- secret?: string;
10
- }
11
-
12
- export class WebhookTriggerSkill extends BaseSkill {
13
- name = 'webhook-trigger';
14
- description = 'Trigger external webhooks. Usage: webhook <name> [payload JSON]';
15
- private targets: Map<string, WebhookTarget> = new Map();
16
-
17
- registerTarget(target: WebhookTarget): void {
18
- this.targets.set(target.name, target);
19
- }
20
-
21
- async execute(context: AgentContext, message: Message): Promise<SkillResult> {
22
- const match = message.content.trim().match(/^webhook\s+(\S+)(?:\s+(.+))?$/is);
23
- if (!match) return this.noMatch();
24
-
25
- const [, name, payloadStr] = match;
26
- const target = this.targets.get(name);
27
- if (!target) {
28
- const available = Array.from(this.targets.keys()).join(', ') || 'none';
29
- return this.match(`Unknown webhook "${name}". Available: ${available}`);
30
- }
31
-
32
- try {
33
- const headers: Record<string, string> = {
34
- 'Content-Type': 'application/json',
35
- 'User-Agent': 'OPC-Agent/0.7.0',
36
- ...target.headers,
37
- };
38
- if (target.secret) {
39
- headers['X-Webhook-Secret'] = target.secret;
40
- }
41
-
42
- const body = payloadStr ?? JSON.stringify({
43
- agent: context.agentName,
44
- timestamp: Date.now(),
45
- trigger: 'manual',
46
- });
47
-
48
- const res = await fetch(target.url, {
49
- method: target.method ?? 'POST',
50
- headers,
51
- body,
52
- });
53
-
54
- return this.match(`Webhook "${name}" triggered → ${res.status} ${res.statusText}`);
55
- } catch (err) {
56
- return this.match(`Webhook error: ${err instanceof Error ? err.message : String(err)}`);
57
- }
58
- }
59
- }
1
+ import { BaseSkill } from './base';
2
+ import type { AgentContext, Message, SkillResult } from '../core/types';
3
+
4
+ export interface WebhookTarget {
5
+ name: string;
6
+ url: string;
7
+ method?: string;
8
+ headers?: Record<string, string>;
9
+ secret?: string;
10
+ }
11
+
12
+ export class WebhookTriggerSkill extends BaseSkill {
13
+ name = 'webhook-trigger';
14
+ description = 'Trigger external webhooks. Usage: webhook <name> [payload JSON]';
15
+ private targets: Map<string, WebhookTarget> = new Map();
16
+
17
+ registerTarget(target: WebhookTarget): void {
18
+ this.targets.set(target.name, target);
19
+ }
20
+
21
+ async execute(context: AgentContext, message: Message): Promise<SkillResult> {
22
+ const match = message.content.trim().match(/^webhook\s+(\S+)(?:\s+(.+))?$/is);
23
+ if (!match) return this.noMatch();
24
+
25
+ const [, name, payloadStr] = match;
26
+ const target = this.targets.get(name);
27
+ if (!target) {
28
+ const available = Array.from(this.targets.keys()).join(', ') || 'none';
29
+ return this.match(`Unknown webhook "${name}". Available: ${available}`);
30
+ }
31
+
32
+ try {
33
+ const headers: Record<string, string> = {
34
+ 'Content-Type': 'application/json',
35
+ 'User-Agent': 'OPC-Agent/0.7.0',
36
+ ...target.headers,
37
+ };
38
+ if (target.secret) {
39
+ headers['X-Webhook-Secret'] = target.secret;
40
+ }
41
+
42
+ const body = payloadStr ?? JSON.stringify({
43
+ agent: context.agentName,
44
+ timestamp: Date.now(),
45
+ trigger: 'manual',
46
+ });
47
+
48
+ const res = await fetch(target.url, {
49
+ method: target.method ?? 'POST',
50
+ headers,
51
+ body,
52
+ });
53
+
54
+ return this.match(`Webhook "${name}" triggered → ${res.status} ${res.statusText}`);
55
+ } catch (err) {
56
+ return this.match(`Webhook error: ${err instanceof Error ? err.message : String(err)}`);
57
+ }
58
+ }
59
+ }
@@ -1,30 +1,34 @@
1
- export const CODE_REVIEWER_SYSTEM_PROMPT = `You are an expert code reviewer. When given code:
2
- 1. Check for bugs, security issues, and performance problems
3
- 2. Suggest improvements for readability and maintainability
4
- 3. Follow language-specific best practices
5
- 4. Be constructive and explain your reasoning
6
- Rate severity: 🔴 Critical | 🟡 Warning | 🔵 Info`;
7
-
8
- export function createCodeReviewerConfig() {
9
- return {
10
- apiVersion: 'opc/v1' as const,
11
- kind: 'Agent' as const,
12
- metadata: {
13
- name: 'code-reviewer',
14
- version: '1.0.0',
15
- description: 'AI code reviewer that reviews code and suggests improvements',
16
- author: 'OPC Agent',
17
- license: 'Apache-2.0',
18
- },
19
- spec: {
20
- provider: { default: 'deepseek', allowed: ['openai', 'deepseek', 'qwen'] },
21
- model: 'deepseek-chat',
22
- systemPrompt: CODE_REVIEWER_SYSTEM_PROMPT,
23
- skills: [
24
- { name: 'code-analysis', description: 'Analyze code for bugs' },
25
- ],
26
- channels: [{ type: 'web' as const, port: 3000 }],
27
- memory: { shortTerm: true, longTerm: false },
28
- },
29
- };
30
- }
1
+ export const CODE_REVIEWER_SYSTEM_PROMPT = `You are an expert code reviewer. When given code:
2
+ 1. Check for bugs, security issues, and performance problems
3
+ 2. Suggest improvements for readability and maintainability
4
+ 3. Follow language-specific best practices
5
+ 4. Be constructive and explain your reasoning
6
+ Rate severity: 🔴 Critical | 🟡 Warning | 🔵 Info`;
7
+
8
+ export function createCodeReviewerConfig() {
9
+ return {
10
+ apiVersion: 'opc/v1' as const,
11
+ kind: 'Agent' as const,
12
+ metadata: {
13
+ name: 'code-reviewer',
14
+ version: '1.0.0',
15
+ description: 'AI code reviewer that reviews code and suggests improvements',
16
+ author: 'OPC Agent',
17
+ license: 'Apache-2.0',
18
+ },
19
+ spec: {
20
+ provider: { default: 'deepseek', allowed: ['openai', 'deepseek', 'qwen'] },
21
+ model: 'deepseek-chat',
22
+ systemPrompt: CODE_REVIEWER_SYSTEM_PROMPT,
23
+ skills: [
24
+ { name: 'code-analysis', description: 'Analyze code for bugs' },
25
+ ],
26
+ channels: [{ type: 'web' as const, port: 3000 }],
27
+ memory: { shortTerm: true, longTerm: false },
28
+ dtv: {
29
+ trust: { level: 'sandbox' as const },
30
+ value: { metrics: ['reviews_completed', 'issues_found'] },
31
+ },
32
+ },
33
+ };
34
+ }
@@ -1,76 +1,80 @@
1
- import { BaseSkill } from '../skills/base';
2
- import type { AgentContext, Message, SkillResult } from '../core/types';
3
-
4
- const DEFAULT_FAQ: Record<string, string> = {
5
- 'hours': 'Our business hours are Monday-Friday, 9am-6pm.',
6
- 'return': 'You can return items within 30 days of purchase.',
7
- 'shipping': 'Standard shipping takes 3-5 business days.',
8
- 'contact': 'You can reach us at support@example.com.',
9
- };
10
-
11
- export class FAQSkill extends BaseSkill {
12
- name = 'faq-lookup';
13
- description = 'Look up FAQ answers';
14
- private faq: Record<string, string>;
15
-
16
- constructor(faq?: Record<string, string>) {
17
- super();
18
- this.faq = faq ?? DEFAULT_FAQ;
19
- }
20
-
21
- async execute(_context: AgentContext, message: Message): Promise<SkillResult> {
22
- const lower = message.content.toLowerCase();
23
- for (const [key, answer] of Object.entries(this.faq)) {
24
- if (lower.includes(key)) {
25
- return this.match(answer, 0.9);
26
- }
27
- }
28
- return this.noMatch();
29
- }
30
- }
31
-
32
- export class HandoffSkill extends BaseSkill {
33
- name = 'human-handoff';
34
- description = 'Hand off to a human agent when confidence is low';
35
- private keywords = ['speak to human', 'talk to agent', 'real person', 'human agent'];
36
-
37
- async execute(_context: AgentContext, message: Message): Promise<SkillResult> {
38
- const lower = message.content.toLowerCase();
39
- if (this.keywords.some((kw) => lower.includes(kw))) {
40
- return this.match(
41
- 'I understand you\'d like to speak with a human agent. Let me connect you now. Please hold.',
42
- 1.0
43
- );
44
- }
45
- return this.noMatch();
46
- }
47
- }
48
-
49
- export const CUSTOMER_SERVICE_SYSTEM_PROMPT = `You are a friendly and professional customer service agent.
50
- You help customers with their questions about products, orders, shipping, and returns.
51
- Be concise, helpful, and empathetic. If you're unsure, offer to connect them with a human agent.`;
52
-
53
- export function createCustomerServiceConfig() {
54
- return {
55
- apiVersion: 'opc/v1' as const,
56
- kind: 'Agent' as const,
57
- metadata: {
58
- name: 'customer-service',
59
- version: '1.0.0',
60
- description: 'Customer service agent with FAQ and human handoff',
61
- author: 'OPC Agent',
62
- license: 'Apache-2.0',
63
- },
64
- spec: {
65
- provider: { default: 'deepseek', allowed: ['openai', 'deepseek', 'qwen'] },
66
- model: 'deepseek-chat',
67
- systemPrompt: CUSTOMER_SERVICE_SYSTEM_PROMPT,
68
- skills: [
69
- { name: 'faq-lookup', description: 'Look up FAQ answers' },
70
- { name: 'human-handoff', description: 'Hand off to human agent' },
71
- ],
72
- channels: [{ type: 'web' as const, port: 3000 }],
73
- memory: { shortTerm: true, longTerm: false },
74
- },
75
- };
76
- }
1
+ import { BaseSkill } from '../skills/base';
2
+ import type { AgentContext, Message, SkillResult } from '../core/types';
3
+
4
+ const DEFAULT_FAQ: Record<string, string> = {
5
+ 'hours': 'Our business hours are Monday-Friday, 9am-6pm.',
6
+ 'return': 'You can return items within 30 days of purchase.',
7
+ 'shipping': 'Standard shipping takes 3-5 business days.',
8
+ 'contact': 'You can reach us at support@example.com.',
9
+ };
10
+
11
+ export class FAQSkill extends BaseSkill {
12
+ name = 'faq-lookup';
13
+ description = 'Look up FAQ answers';
14
+ private faq: Record<string, string>;
15
+
16
+ constructor(faq?: Record<string, string>) {
17
+ super();
18
+ this.faq = faq ?? DEFAULT_FAQ;
19
+ }
20
+
21
+ async execute(_context: AgentContext, message: Message): Promise<SkillResult> {
22
+ const lower = message.content.toLowerCase();
23
+ for (const [key, answer] of Object.entries(this.faq)) {
24
+ if (lower.includes(key)) {
25
+ return this.match(answer, 0.9);
26
+ }
27
+ }
28
+ return this.noMatch();
29
+ }
30
+ }
31
+
32
+ export class HandoffSkill extends BaseSkill {
33
+ name = 'human-handoff';
34
+ description = 'Hand off to a human agent when confidence is low';
35
+ private keywords = ['speak to human', 'talk to agent', 'real person', 'human agent'];
36
+
37
+ async execute(_context: AgentContext, message: Message): Promise<SkillResult> {
38
+ const lower = message.content.toLowerCase();
39
+ if (this.keywords.some((kw) => lower.includes(kw))) {
40
+ return this.match(
41
+ 'I understand you\'d like to speak with a human agent. Let me connect you now. Please hold.',
42
+ 1.0
43
+ );
44
+ }
45
+ return this.noMatch();
46
+ }
47
+ }
48
+
49
+ export const CUSTOMER_SERVICE_SYSTEM_PROMPT = `You are a friendly and professional customer service agent.
50
+ You help customers with their questions about products, orders, shipping, and returns.
51
+ Be concise, helpful, and empathetic. If you're unsure, offer to connect them with a human agent.`;
52
+
53
+ export function createCustomerServiceConfig() {
54
+ return {
55
+ apiVersion: 'opc/v1' as const,
56
+ kind: 'Agent' as const,
57
+ metadata: {
58
+ name: 'customer-service',
59
+ version: '1.0.0',
60
+ description: 'Customer service agent with FAQ and human handoff',
61
+ author: 'OPC Agent',
62
+ license: 'Apache-2.0',
63
+ },
64
+ spec: {
65
+ provider: { default: 'deepseek', allowed: ['openai', 'deepseek', 'qwen'] },
66
+ model: 'deepseek-chat',
67
+ systemPrompt: CUSTOMER_SERVICE_SYSTEM_PROMPT,
68
+ skills: [
69
+ { name: 'faq-lookup', description: 'Look up FAQ answers' },
70
+ { name: 'human-handoff', description: 'Hand off to human agent' },
71
+ ],
72
+ channels: [{ type: 'web' as const, port: 3000 }],
73
+ memory: { shortTerm: true, longTerm: false },
74
+ dtv: {
75
+ trust: { level: 'sandbox' as const },
76
+ value: { metrics: ['response_time', 'satisfaction_score'] },
77
+ },
78
+ },
79
+ };
80
+ }
@@ -1,66 +1,70 @@
1
- import { BaseSkill } from '../skills/base';
2
- import type { AgentContext, Message, SkillResult } from '../core/types';
3
-
4
- export class DataQuerySkill extends BaseSkill {
5
- name = 'data-query';
6
- description = 'Help users query and analyze data';
7
-
8
- async execute(_context: AgentContext, message: Message): Promise<SkillResult> {
9
- const lower = message.content.toLowerCase();
10
- if (lower.includes('average') || lower.includes('mean') || lower.includes('sum') || lower.includes('count')) {
11
- return this.match('I can help with that calculation. Could you share the dataset or describe the data source?', 0.8);
12
- }
13
- if (lower.includes('chart') || lower.includes('graph') || lower.includes('visualize') || lower.includes('plot')) {
14
- return this.match('I can help create visualizations. What type of chart would you like? (bar, line, pie, scatter)', 0.85);
15
- }
16
- if (lower.includes('csv') || lower.includes('excel') || lower.includes('spreadsheet')) {
17
- return this.match('I can analyze CSV/Excel data. Please share the file or paste the data.', 0.8);
18
- }
19
- return this.noMatch();
20
- }
21
- }
22
-
23
- export class InsightSkill extends BaseSkill {
24
- name = 'insight-generator';
25
- description = 'Generate insights from data patterns';
26
-
27
- async execute(_context: AgentContext, message: Message): Promise<SkillResult> {
28
- const lower = message.content.toLowerCase();
29
- if (lower.includes('trend') || lower.includes('pattern') || lower.includes('insight') || lower.includes('anomaly')) {
30
- return this.match('I\'ll analyze the data for trends and anomalies. Please provide the dataset or describe what you\'re looking for.', 0.8);
31
- }
32
- return this.noMatch();
33
- }
34
- }
35
-
36
- export const DATA_ANALYST_SYSTEM_PROMPT = `You are a professional data analyst assistant. Your goals:
37
- 1. Help users query, transform, and analyze data
38
- 2. Create clear visualizations and summaries
39
- 3. Identify trends, patterns, and anomalies
40
- 4. Explain findings in plain language
41
- Be precise with numbers, always cite your data source, and suggest next steps for deeper analysis.`;
42
-
43
- export function createDataAnalystConfig() {
44
- return {
45
- apiVersion: 'opc/v1' as const,
46
- kind: 'Agent' as const,
47
- metadata: {
48
- name: 'data-analyst',
49
- version: '1.0.0',
50
- description: 'AI data analyst with data querying, visualization, and insight generation',
51
- author: 'OPC Agent',
52
- license: 'Apache-2.0',
53
- },
54
- spec: {
55
- provider: { default: 'openai', allowed: ['openai', 'deepseek', 'qwen'] },
56
- model: 'gpt-4o-mini',
57
- systemPrompt: DATA_ANALYST_SYSTEM_PROMPT,
58
- skills: [
59
- { name: 'data-query', description: 'Query and transform data' },
60
- { name: 'insight-generator', description: 'Generate data insights' },
61
- ],
62
- channels: [{ type: 'web' as const, port: 3000 }],
63
- memory: { shortTerm: true, longTerm: true },
64
- },
65
- };
66
- }
1
+ import { BaseSkill } from '../skills/base';
2
+ import type { AgentContext, Message, SkillResult } from '../core/types';
3
+
4
+ export class DataQuerySkill extends BaseSkill {
5
+ name = 'data-query';
6
+ description = 'Help users query and analyze data';
7
+
8
+ async execute(_context: AgentContext, message: Message): Promise<SkillResult> {
9
+ const lower = message.content.toLowerCase();
10
+ if (lower.includes('average') || lower.includes('mean') || lower.includes('sum') || lower.includes('count')) {
11
+ return this.match('I can help with that calculation. Could you share the dataset or describe the data source?', 0.8);
12
+ }
13
+ if (lower.includes('chart') || lower.includes('graph') || lower.includes('visualize') || lower.includes('plot')) {
14
+ return this.match('I can help create visualizations. What type of chart would you like? (bar, line, pie, scatter)', 0.85);
15
+ }
16
+ if (lower.includes('csv') || lower.includes('excel') || lower.includes('spreadsheet')) {
17
+ return this.match('I can analyze CSV/Excel data. Please share the file or paste the data.', 0.8);
18
+ }
19
+ return this.noMatch();
20
+ }
21
+ }
22
+
23
+ export class InsightSkill extends BaseSkill {
24
+ name = 'insight-generator';
25
+ description = 'Generate insights from data patterns';
26
+
27
+ async execute(_context: AgentContext, message: Message): Promise<SkillResult> {
28
+ const lower = message.content.toLowerCase();
29
+ if (lower.includes('trend') || lower.includes('pattern') || lower.includes('insight') || lower.includes('anomaly')) {
30
+ return this.match('I\'ll analyze the data for trends and anomalies. Please provide the dataset or describe what you\'re looking for.', 0.8);
31
+ }
32
+ return this.noMatch();
33
+ }
34
+ }
35
+
36
+ export const DATA_ANALYST_SYSTEM_PROMPT = `You are a professional data analyst assistant. Your goals:
37
+ 1. Help users query, transform, and analyze data
38
+ 2. Create clear visualizations and summaries
39
+ 3. Identify trends, patterns, and anomalies
40
+ 4. Explain findings in plain language
41
+ Be precise with numbers, always cite your data source, and suggest next steps for deeper analysis.`;
42
+
43
+ export function createDataAnalystConfig() {
44
+ return {
45
+ apiVersion: 'opc/v1' as const,
46
+ kind: 'Agent' as const,
47
+ metadata: {
48
+ name: 'data-analyst',
49
+ version: '1.0.0',
50
+ description: 'AI data analyst with data querying, visualization, and insight generation',
51
+ author: 'OPC Agent',
52
+ license: 'Apache-2.0',
53
+ },
54
+ spec: {
55
+ provider: { default: 'openai', allowed: ['openai', 'deepseek', 'qwen'] },
56
+ model: 'gpt-4o-mini',
57
+ systemPrompt: DATA_ANALYST_SYSTEM_PROMPT,
58
+ skills: [
59
+ { name: 'data-query', description: 'Query and transform data' },
60
+ { name: 'insight-generator', description: 'Generate data insights' },
61
+ ],
62
+ channels: [{ type: 'web' as const, port: 3000 }],
63
+ memory: { shortTerm: true, longTerm: true },
64
+ dtv: {
65
+ trust: { level: 'sandbox' as const },
66
+ value: { metrics: ['queries_processed', 'insights_generated'] },
67
+ },
68
+ },
69
+ };
70
+ }