opc-agent 1.3.2 → 1.4.0

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