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